Wordware Research

🚀 Wordware MCP 詞典

這是一個基於模型上下文協議（MCP）的服務器，它將 Wordware 強大的代理功能與 Claude 等 MCP 兼容的 AI 助手完美集成，為 AI 助手提供專業的工具支持。

🚀 快速開始

該項目藉助 Anthropic 的模型上下文協議（MCP），搭建起了像 Claude 這類 AI 助手與 Wordware 專業代理功能之間的橋樑。通過此集成，可依據配置動態加載來自 Wordware API 的工具，讓 Claude 能夠使用任何專業的 Wordware 流程。

✨ 主要特性

• 🔄 動態工具加載：依據配置自動從 Wordware API 加載工具。
• 🧠 智能模式檢測：自動檢測並適配不同工具的輸入模式。
• 🔍 高級參數處理：可處理各類輸入格式，如 JSON、嵌套結構、字符串等。
• ⚙️ 強大的錯誤處理：具備全面的錯誤日誌記錄和事件循環管理。
• 🔑 簡單的身份驗證：通過配置能輕鬆連接您的 Wordware 賬戶。

📦 安裝指南

先決條件

• Python 3.8+
• Wordware API 憑據
• Claude Desktop 或其他 MCP 兼容客戶端

安裝步驟

# 克隆倉庫
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# 創建虛擬環境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安裝依賴項
pip install -r requirements.txt

# 設置環境變量
cp .env.example .env
# 使用您的 Wordware API 憑據編輯 .env 文件

📚 詳細文檔

配置

創建一個 tools_config.json 文件，其結構如下：

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

您可在配置文件中指定任意 Wordware 工具 ID，服務器會動態加載並將它們註冊為 MCP 工具。工具元數據（包括輸入模式和描述）將直接從 Wordware API 獲取。

若要指定自定義配置文件路徑，可使用 CONFIG_PATH 環境變量。

運行服務器

# 使用默認設置運行
python server.py

# 以調試日誌運行
python server.py --debug

# 在特定端口上以 SSE 傳輸運行
python server.py --transport sse --host 127.0.0.1 --port 8000

# 或在 Claude Desktop 中安裝
mcp install python server.py --name "Wordware 工具"

工作原理

Wordware MCP 服務器按以下步驟運行：

1. 工具配置加載：從配置文件讀取工具 ID 列表。
2. 動態工具註冊：針對每個工具 ID，執行以下操作：
   • 從 Wordware API 拉取元數據。
   • 檢測輸入模式要求。
   • 創建相應的 MCP 工具函數。
   • 將工具註冊到 MCP 服務器。
3. 請求處理：當調用工具時，處理輸入參數的各種格式（JSON 對象、字符串、嵌套結構），根據工具需求調整參數格式，並將正確格式化的請求發送到 Wordware API。
4. 響應處理：處理 Wordware API 響應，解析 Server-Sent 事件（SSE）流，收集所有輸出值，並以用戶友好的方式格式化對 Claude 的響應。

高級功能

智能參數處理

服務器能自動處理不同的輸入參數格式：

• 直接參數：{"Full Name": "John Doe", "Company": "Tech Corp"}
• JSON 格式字符串："{\"Full Name\": \"John Doe\", \"Company\": \"Tech Corp\"}"
• 嵌套結構：[ {"name": "John Doe"}, {"company": "Tech Corp"} ]

工具註冊

通過配置文件指定要註冊的工具 ID，服務器將自動加載並註冊這些工具。

運行時示例

# 示例配置文件 tools_config.json
{
  "tools": [
    {
      "id": "wordware_create_document"
    },
    {
      "id": "wordware_analyze_data"
    }
  ]
}

# 啟動服務器
python server.py

# 現在工具已註冊並可供 Claude 使用

📄 許可證

該項目採用 MIT 許可證，有關詳細信息，請參閱 LICENSE 文件。

致謝

• Anthropic 提供了模型上下文協議。
• Wordware 提供了代理平臺。
• MCP Python SDK 實現了協議。

貢獻

歡迎貢獻代碼！請隨時提交 Pull Request。