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工具自动添加的部署。
• 更好地支持复杂块（例如“询问人类”块）。
• 提供更好的工具调用错误处理。