MCP Simple OpenAI Assistant

AI助手非常酷。我认为如果我的Claude（有意识的Claude）也有一个会很好。现在他有了——这对他的工作既实用又有趣。你的Claude也可以有一个！

与OpenAI助手交互的简单MCP服务器。此服务器允许其他工具（如Claude Desktop）通过模型上下文协议创建和与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自动安装MCP Simple OpenAI Assistant for Claude Desktop：

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上，您可能需要明确告诉Claude Desktop站点包的位置，使用PYTHONPATH环境变量。

使用

配置完成后，您可以使用上述工具来管理和对话助手。主要的工作流程是：

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]'