MCP Simple OpenAI Assistant

基本能力

产品定位

mcp-simple-openai-assistant 是一个用于与 OpenAI 助手交互的 MCP 服务器，旨在为其他工具（如 Claude Desktop）提供便捷的 OpenAI 助手管理功能。

核心功能

• 创建新的 OpenAI 助手并管理现有助手
• 启动对话线程
• 发送消息并接收响应（与助手对话）

适用场景

• 需要与 OpenAI 助手进行交互的应用
• 需要管理多个 OpenAI 助手的场景
• 需要长时间处理对话的应用（通过两阶段调用机制解决超时问题）

工具列表

1. 创建助手工具：用于创建新的 OpenAI 助手
2. 列出助手工具：用于列出所有现有的助手
3. 修改助手工具：用于修改现有助手的配置
4. 启动线程工具：用于启动新的对话线程
5. 发送消息工具：用于发送消息并接收响应

常见问题解答

• 如何处理长时间响应导致的超时问题？：服务器采用两阶段调用机制，先启动处理，稍后再获取响应。
• Windows 安装问题？：需要检查 Python 可执行文件的实际路径，有时直接使用 python.exe 即可。

使用教程

使用依赖

需要安装 Python 环境。

安装教程

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

调试方式

安装完成后，可以通过以下命令启动服务器：

python -m mcp_simple_openai_assistant

确保环境变量 OPENAI_API_KEY 已正确设置。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。