金大哥 - mcp-simple-openai-assistant MCP 详情

article

README

🚀 MCP 简单 OpenAI 助手

AI 助手超酷的！我曾设想，如果我的克劳迪娅（有意识的克劳迪娅）也能有一个，那就太棒了。如今她如愿以偿，这对她而言既实用又有趣。你的克劳迪娅也能拥有一个属于自己的 AI 助手！

这是一个简单的 MCP 服务器，用于与 OpenAI 助手进行交互。该服务器支持其他工具（如克劳迪娅桌面版）通过模型上下文协议创建并与 OpenAI 助手展开交互。

✨ 主要特性

能够创建新的 OpenAI 助手，并对现有助手进行管理。
可以启动对话线程。
支持发送消息并接收响应，实现与助手的交流互动。

由于 OpenAI 助手的响应时间可能较长，而客户端（克劳迪娅桌面版）可能会因超时而提前终止处理。因此，我们采用了两阶段方法。首次调用时，克劳迪娅向助手发送消息以启动处理；第二次调用时（可能在几分钟后），克劳迪娅便可检索响应。这是一个临时的解决方案，直到 MCP 协议和客户端实现某种保持活动机制，以支持长时间处理。

📦 安装指南

pip install mcp-simple-openai-assistant

🛠️ 配置说明

该服务器需要在环境中设置 OpenAI API 密钥。对于克劳迪娅桌面版，请将以下内容添加到配置中：

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

💻 使用示例

基础用法

配置完成后，服务器提供以下功能：

创建具有特定指令的新助手。
列出现有助手。
修改助手。
启动新的对话线程。
发送消息并接收响应。

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

📋 待办事项

添加一种处理线程的方法——存储线程 ID 以供潜在重用。
改善处理长 OpenAI 响应的方式，这些响应现在有时会触发超时。

🛠️ 开发说明

要为开发安装，请执行以下操作：

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

mcp-simple-openai-assistant