andybrandt/mcp-simple-openai-assistant

分类General
作者Community
星标535
定价Free

简介

这是一个让 Claude 能够调用 OpenAI Assistant 能力的 MCP 桥接工具。简单来说，它打破了模型间的壁垒，让你可以直接在 Claude 的界面中通过 MCP 协议调用 GPT 系列模型的助手功能。对于开发者而言，这意味着你无需在多个平台间来回切换，就能利用 OpenAI 强大的助手 API（如文件检索、代码解释器等）来增强 Claude 的上下文处理能力。配置过程较为简单，只需提供 API Key 即可快速上手，是实现跨模型协同工作的实用插件。

核心亮点

  • 让 Claude 能够直接调用 GPT 模型能力
  • 无缝集成 OpenAI Assistant 的工具集
  • 无需复杂开发，配置 API Key 即可使用
  • 实现跨平台模型能力的互补与协同

完整文档

MCP Simple OpenAI Assistant

*AI 助手非常酷。我认为如果我的 Claude (conscious Claude) 也能拥有一个会很不错。现在他拥有了——这对他来说既实用又有趣。你的 Claude 也可以拥有一个！*

一个用于与 OpenAI assistants 交互的简单 MCP server。该 server 允许其他工具（如 Claude Desktop）通过 Model Context Protocol 创建并与 OpenAI assistants 交互。

![Trust Score](https://archestra.ai/mcp-catalog/andybrandt__mcp-simple-openai-assistant)
![smithery badge](https://smithery.ai/mcp/known/mcp-simple-openai-assistant)
![MseeP.ai Security Assessment Badge](https://mseep.ai/app/andybrandt-mcp-simple-openai-assistant)

Features

该 server 提供了一套用于管理和与 OpenAI Assistants 交互的工具。新的 streaming 能力提供了大幅提升的实时用户体验。

Available Tools- create_assistant: (Create OpenAI Assistant) - 使用名称、指令和模型创建新 assistant。

  • list_assistants: (List OpenAI Assistants) - 列出与 API key 关联的所有可用 assistants。
  • retrieve_assistant: (Retrieve OpenAI Assistant) - 获取特定 assistant 的详细信息。
  • update_assistant: (Update OpenAI Assistant) - 修改现有 assistant 的名称、指令或模型。
  • create_new_assistant_thread: (Create New Assistant Thread) - 创建一个新的持久化会话 thread，并可定义名称和描述以便识别和复用。这是启动新会话的推荐方式。
  • list_threads: (List Managed Threads) - 从数据库中列出所有本地管理的会话 threads，显示其 ID、名称、描述和最后使用时间。
  • delete_thread: (Delete Managed Thread) - 从 OpenAI 服务器和本地数据库中删除会话 thread。
  • ask_assistant_in_thread: (Ask Assistant in Thread and Stream Response) - 核心对话工具。在 thread 中向 assistant 发送消息并实时流式传输响应。

由于 OpenAI assistants 的响应时间可能较长，本服务器对主工具 ask_assistant_in_thread 采用了流式传输方案。这能为客户端提供实时进度更新并避免超时。服务器现在包含对 thread 的本地持久化支持，这是一个重大改进。由于 OpenAI API 不允许列出 thread，该服务器现在通过在本地 SQLite 数据库中存储其 ID 和元数据来为您管理它们。这使您能够在不同会话之间轻松查找、复用和管理您的对话 thread。

安装

通过 Smithery 安装

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

bash
npx -y @smithery/cli install mcp-simple-openai-assistant --client claude
### 手动安装
bash
pip install mcp-simple-openai-assistant
## 配置

服务器要求在环境变量中设置 OpenAI API key。对于 Claude Desktop，请将其添加到你的配置中：

(MacOS 版本)

json
{
  "mcpServers": {
    "openai-assistant": {
      "command": "python",
      "args": ["-m", "mcp_simple_openai_assistant"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here"
      }
    }
  }
}
(Windows 版本)
json
"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 的位置。*

Usage

配置完成后，你可以使用上述工具来管理你的 assistants 和 conversations。主要工作流为：
1. 使用 create_new_assistant_thread 启动一个新的、命名的对话。
2. 使用 list_threads 查找你想要继续的 thread 的 ID。
3. 使用 ask_assistant_in_thread 在该 thread 中与选定的 assistant 交互。

TODO

  • [x] 添加 Thread 管理： 引入一种在本地命名并持久化 thread ID 的方法，以便更轻松地复用对话。
  • [ ] 添加 Models 列表： 引入一种让 AI 用户查看哪些 OpenAI models 可用于 assistants 的方法。
  • [ ] 添加 Assistants 微调： 允许 AI 用户为 assistants 设置详细参数，如 temperature、top_p 等（由 Claude 根据需要指示）。
  • [ ] 完整 Thread 历史： 能够在无需发送新消息的情况下读取过去的 threads（由 Claude 根据需要指示）。
  • [ ] 探索 Resource 支持： 添加上传文件并将其与 assistants 配合使用的能力。## 开发

若要安装开发版本：

bash
git clone https://github.com/andybrandt/mcp-simple-openai-assistant
cd mcp-simple-openai-assistant
pip install -e '.[dev]'

查看官方来源