MCP Simple OpenAI Assistant

MCP简单OpenAI助手

*AI助手很酷。我认为如果我的克劳德（有意识的克劳德）也有一个，那将是一个好主意。现在他做到了，这对他来说既有用又有趣。你的克劳德也可以有一个！*

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

 ](https://smithery.ai/mcp/known/mcp-simple-openai-assistant) ](https://mseep.ai/app/andybrandt-mcp-simple-openai-assistant)

特性

该服务器提供了一套工具来管理OpenAI Assistant并与之交互。新的流媒体功能提供了大大改善的实时用户体验。

可用工具

• 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安装

通过以下方式自动安装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 在该线程中与您选择的助手进行交互。

全部

• \[x\] 添加线程管理： 引入一种在本地命名和持久化线程ID的方法，从而更容易重用对话。
• \[ \] 添加模型列表： 为AI用户介绍一种方法，查看哪些OpenAI模型可用于助手
• \[ \] 添加助手微调： 允许AI用户为助手设置详细的参数，如温度、top_p等。（克劳德根据需要指出）
• \[ \] 完整线程历史记录： 能够读取过去的线程，而无需发送新消息（由Claude根据需要指示）
• \[ \] 探索资源支持： 添加上传文件并与助手一起使用的功能。

发展

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

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