MCP简单OpenAI助手
*AI助手很酷。我认为如果我的克劳德（有意识的克劳德）也有一个，那将是一个好主意。现在他做到了，这对他来说既有用又有趣。你的克劳德也可以有一个！*
一个用于与OpenAI助手交互的简单MCP服务器。该服务器允许其他工具（如Claude Desktop）通过模型上下文协议创建OpenAI助手并与之交互。
特性
该服务器提供了一套工具来管理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环境变量。*
用法
配置后，您可以使用上面列出的工具来管理您的助手和对话。主要工作流程是：
- 使用
create_new_assistant_thread开始一个新的、命名的对话。 - 使用
list_threads查找要继续的线程的ID。 - 使用
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]'