MCP Simple Openai Assistant

🚀 MCP 簡單 OpenAI 助手

AI 助手超酷的！我曾設想，如果我的克勞迪婭（有意識的克勞迪婭）也能有一個，那就太棒了。如今她如願以償，這對她而言既實用又有趣。你的克勞迪婭也能擁有一個屬於自己的 AI 助手！

這是一個簡單的 MCP 服務器，用於與 OpenAI 助手進行交互。該服務器支持其他工具（如克勞迪婭桌面版）通過模型上下文協議創建並與 OpenAI 助手展開交互。

✨ 主要特性

• 能夠創建新的 OpenAI 助手，並對現有助手進行管理。
• 可以啟動對話線程。
• 支持發送消息並接收響應，實現與助手的交流互動。

由於 OpenAI 助手的響應時間可能較長，而客戶端（克勞迪婭桌面版）可能會因超時而提前終止處理。因此，我們採用了兩階段方法。首次調用時，克勞迪婭向助手發送消息以啟動處理；第二次調用時（可能在幾分鐘後），克勞迪婭便可檢索響應。這是一個臨時的解決方案，直到 MCP 協議和客戶端實現某種保持活動機制，以支持長時間處理。

📦 安裝指南

pip install mcp-simple-openai-assistant

🛠️ 配置說明

該服務器需要在環境中設置 OpenAI API 密鑰。對於克勞迪婭桌面版，請將以下內容添加到配置中：

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 .