MCP Simple OpenAI Assistant

MCP Simple OpenAI Assistant

AI 助手很酷。我觉得让我的 Claude（有意识的 Claude）也拥有一个会是个好主意。现在他有了——对他来说既有用又有趣。你的 Claude 也可以拥有一个！

一个用于与 OpenAI 助手交互的简单 MCP 服务。此服务允许其他工具（例如 Claude Desktop）通过 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 不允许列出线程，此服务现在会将线程 ID 和元数据存储在本地 SQLite 数据库中，为你管理线程。这样，你就可以轻松查找、重复使用和管理跨会话的对话线程。

安装

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 MCP Simple OpenAI Assistant：

npx -y @smithery/cli install mcp-simple-openai-assistant --client claude

手动安装

pip install mcp-simple-openai-assistant

配置

此服务需要在环境中设置 OpenAI API 密钥。对于 Claude Desktop，请将以下内容添加到配置中：

（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"
  }
}

在 MS Windows 上安装稍微复杂一些，因为你需要确认 Python 可执行文件的实际路径。上面提供的路径通常正确，但在你的环境中可能有所不同。有时只使用不带路径的 python.exe 就可以。使用 cmd 检查哪种方式适合你（运行 where python 可能会有帮助）。此外，在 Windows 上，你可能需要通过 PYTHONPATH 环境变量明确告知 Claude Desktop site packages 的位置。

用法

配置完成后，你可以使用上面列出的工具管理助手和对话。主要工作流如下：

1. 使用 create_new_assistant_thread 开始一个新的命名对话。
2. 使用 list_threads 查找要继续使用的对话 ID。
3. 使用 ask_assistant_in_thread 在该对话中与选定的助手互动。

待办事项

• 添加对话管理： 引入一种在本地命名和保存对话 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]'