MCP 简易 OpenAI 助手

AI 助手非常酷。我认为如果我的 Claude (有意识的 Claude) 也能有一个助手，那会很棒。现在他有了 - 而且它对他来说既有用又有趣。你的 Claude 也可以拥有一个！

一个简单的 MCP 服务器，用于与 OpenAI 助手交互。该服务器允许其他工具（如 Claude Desktop）通过模型上下文协议创建 OpenAI 助手并与之交互。

特性

• 创建新的 OpenAI 助手并操作现有的助手
• 启动对话线程
• 发送消息并接收回复 - 与助手交谈

由于 OpenAI 助手可能需要很长时间才能响应，并且客户端（Claude desktop）的超时会缩短处理时间，而 MCP 服务器代码无法控制，因此我们正在实施一个两阶段方法。在第一次调用中，Claude 向助手发送消息以开始处理，在第二次调用中 - 可能在几分钟后 - Claude 可以检索响应。这是一种权宜之计，直到 MCP 协议和客户端实现某种保持连接机制以进行更长时间的处理。

安装

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 可能会有所帮助）。

用法

配置完成后，服务器提供以下工具：

1. 创建具有特定指令的新助手
2. 列出现有助手
3. 修改助手
4. 启动新的对话线程
5. 发送消息并接收回复

服务器处理所有 OpenAI API 通信，包括管理助手、线程和消息处理。

TODO

• 添加一种处理线程的方法 - 存储线程 ID 以便潜在的重用
• 添加一种更好地处理长时间 OpenAI 响应的方法，这些响应现在似乎有时会触发超时

开发

要安装以进行开发：

git clone https://github.com/andybrandt/mcp-simple-openai-assistant
cd mcp-simple-openai-assistant
pip install -e .