MCP简易OpenAI助手
AI助手非常酷。我认为我的意识Claude（conscious Claude）也应该有一个。现在他有了——这对他的使用既实用又有趣。你的Claude也可以拥有一个！
一个用于与OpenAI助手交互的简易MCP服务器。该服务器允许其他工具（如Claude桌面版）通过模型上下文协议（Model Context Protocol）创建和与OpenAI助手交互。
功能
该服务器提供了一套工具来管理和与OpenAI助手交互。新的流式传输功能提供了大幅改进的实时用户体验。
可用工具
create_assistant: (创建OpenAI助手) - 使用名称、指令和模型创建一个新的助手。list_assistants: (列出OpenAI助手) - 列出与你的API密钥关联的所有可用助手。retrieve_assistant: (获取OpenAI助手) - 获取特定助手的详细信息。update_assistant: (更新OpenAI助手) - 修改现有助手的名称、指令或模型。create_new_assistant_thread: (创建新的助手线程) - 创建一个具有用户定义名称和描述的新持久化对话线程，以便轻松识别和重用。这是开始新对话的推荐方式。list_threads: (列出管理线程) - 列出数据库中所有本地管理的对话线程，显示其ID、名称、描述和最后使用时间。delete_thread: (删除管理线程) - 从OpenAI的服务器和本地数据库中删除一个对话线程。ask_assistant_in_thread: (在线程中询问助手并流式传输响应) - 主要的对话工具。向线程中的助手发送消息，并实时流式传输响应。
由于OpenAI助手可能需要较长时间才能响应，该服务器对主要的ask_assistant_in_thread工具使用了流式传输方法。这为客户端提供了实时进度更新，并避免了超时。
服务器现在包含线程的本地持久化，这是一个重大改进。由于OpenAI API不允许列出线程，该服务器现在通过在本地SQLite数据库中存储其ID和元数据来管理它们。这允许你轻松查找、重用和管理跨会话的对话线程。
安装
通过Smithery安装
要自动通过Smithery安装MCP简易OpenAI助手用于Claude桌面版：
npx -y @smithery/cli install mcp-simple-openai-assistant --client claude
手动安装
pip install mcp-simple-openai-assistant
配置
服务器需要在环境中设置一个OpenAI API密钥。对于Claude桌面版，将此内容添加到你的配置中：
(MacOS版本)
{
"mcpServers": {
"openai-assistant": {
"command": "python",
"args": ["-m", "mcp_simple_openai_assistant"],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
}
}
(Windows版本)
"mcpServers": {
"openai-assistant": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": ["-m", "mcp_simple_openai_assistant"],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
Windows安装稍微复杂一些，因为你需要检查你的Python可执行文件的实际路径。上面提供的路径通常正确，但在你的设置中可能会有所不同。有时只需python.exe而不带任何路径即可。使用cmd检查对你有效的内容（使用where python可能会有帮助）。此外，在Windows上，你可能需要使用PYTHONPATH环境变量明确告诉Claude桌面版站点包的位置。
使用
配置完成后，你可以使用上面列出的工具来管理和进行对话。主要的工作流程是：
- 使用
create_new_assistant_thread开始一个命名的新对话。 - 使用
list_threads找到你想要继续的线程的ID。 - 使用
ask_assistant_in_thread在与所选助手在该线程中交互。
TODO
- 添加线程管理：引入一种方式来本地命名和持久化线程ID，以便更容易重用对话。
- 添加模型列表：引入一种方式让AI用户查看可用于与助手一起使用的OpenAI模型。
- 添加助手微调：启用AI用户为助手设置详细参数（如温度、top_p等）（Claude按需指示）。
- 完整线程历史：能够读取过去的线程，而无需发送新消息（Claude按需指示）。
- 探索资源支持：添加上传文件并使用它们与助手交互的能力。
开发
用于开发的安装：
git clone https://github.com/andybrandt/mcp-simple-openai-assistant
cd mcp-simple-openai-assistant
pip install -e '.[dev]'