Wordware

🚀 Wordware MCP 服務器

本項目是一個模型上下文協議（MCP）服務器的實現，它能夠將部署在Wordware上的流程，直接作為工具集成到Claude對話中使用，為用戶提供更便捷的交互體驗。

✨ 主要特性

• 協議集成：可與Claude通過MCP協議進行集成。
• 工具支持：支持多種基本的Wordware工具，具體如下：
  • 研究創始人：可進行全面的創始人分析，為會議準備提供有力支持。
  • 領導豐富度：能開展銷售prospects調研，提供相關情報。
  • 保存到Notion：可將頁面直接保存到Notion。
  • React Agent：藉助Google搜索和API功能來解決問題。

📦 安裝指南

1. 配置環境變量

修改根目錄中的 env.example.ts 文件，將其重命名為 env.ts 並設置其中的變量。由於使用常規的.env文件似乎有些複雜（因為還需要將這些變量傳遞給服務器環境，並在Claude Desktop配置中使用），如果有更好的解決方案再回來解決。具體變量如下：

• OPENAI_API_KEY：您的OpenAI API密鑰（用於在 add-tool.ts 中從有關Wordware流程的信息生成zod模式）
• NOTION_SECRET：您的Notion秘密
• NOTION_PARENT_PAGE_ID：保存到的Notion頁面ID
• SAVE_TO_NOTION_APP_ID：您部署的“保存到Notion”應用的ID
• RESEARCH_FOUNDER_APP_ID：您部署的“研究創始人”應用的ID
• LEAD_ENRICHMENT_APP_ID：您部署的“領導豐富度”應用的ID
• REACT_AGENT_APP_ID：您部署的“React Agent”應用的ID

要為saveToNotion工具在Notion上進行設置，請按照此處的說明操作。如果您不想使用其中一個工具，則可以留空對應的環境變量，該工具將不會被註冊。

2. 安裝依賴並構建服務器

在終端中執行以下命令，安裝依賴項並構建服務器：

npm install
npm run build-server

3. 使用Claude Desktop進行服務器測試

您需要安裝了Claude Desktop才能測試服務器。如果已經安裝，請修改配置文件以使用MCP服務器。運行以下命令以打開配置文件（如果您使用的是VSCode）：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

然後在文件中添加以下內容（請確保將/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js替換為本倉庫build文件夾中index.js文件的絕對路徑）：

{
  "mcpServers": {
    "wordware": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js"]
    }
  }
}

4. 使用add-tool命令（可選但推薦）

注意：add-tool命令僅在少數簡單的Wordware流程上進行了測試。由於它依賴於OpenAI來生成模式，請確保驗證工具輸出之前使用。要運行該工具，在終端中執行以下命令：

npm run add-tool

🔧 技術細節

動態工具配置

目前，工具是硬編碼在服務器實現中。未來的改進應集中在以下幾個方面：

• 實現與Wordware API的身份驗證。
• 添加自動獲取用戶部署的功能。
• 確定可以作為MCP工具自動添加的部署。
• 更好地支持複雜塊（例如“詢問人類”塊）。
• 提供更好的工具調用錯誤處理。