MCP Simple OpenAI Assistant

MIT License
18
  • Apple

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Allows creating and interacting with OpenAI assistants through the Model Context Protocol (MCP). Enables sending messages to OpenAI assistants and receiving responses, creating new assistants with specific instructions, listing existing assistants, modifying assistants, and managing conversation threads.

MCP 简单 OpenAI 助手

AI助手真酷。我觉得如果我的克劳德(有意识的克劳德)也能拥有一个就好了。现在他真的有了——这对他来说既实用又有趣。你的克劳德也可以拥有一个!

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

特征

  • 创建新的 OpenAI 助手并操作现有的助手
  • 开始对话主题
  • 发送消息并接收回复 - 与助手交谈

由于 OpenAI 助手可能需要很长时间才能响应,并且由于客户端(Claude 桌面)超时(MCP 服务器代码无法控制)而导致处理中断,因此我们实施了两阶段方法。在第一次调用中,Claude 向助手发送消息以启动处理;在第二次调用中(可能几分钟后),Claude 可以检索响应。这是一种变通方法,直到 MCP 协议和客户端实现某种保持连接机制以应对更长时间的处理。

安装

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

用法

配置完成后,服务器将提供以下工具:

  1. 创建新助手并指定具体指令
  2. 列出现有助手
  3. 修改助手
  4. 开始新的对话主题
  5. 发送消息并接收回复

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

待办事项

  • 添加处理线程的方法 - 存储线程 ID 以供将来重复使用
  • 添加一种方法来更好地处理较长的 OpenAI 响应,这些响应现在似乎有时会触发超时

发展

为开发而安装:

git clone https://github.com/andybrandt/mcp-simple-openai-assistant cd mcp-simple-openai-assistant pip install -e .
-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. TODO
            1. Development
              ID: nk1sfnsu4m