Wordware MCP 服务器

一个模型上下文协议 (MCP) 服务器的实现，它能够将您部署的 Wordware 工作流集成为可以直接在 Claude 对话中使用的工具。

功能

• 通过 MCP 与 Claude 集成
• 支持基本的 Wordware 工具，包括：
  • 创始人研究：全面的创始人分析和会议准备
  • 潜在客户挖掘：销售线索研究和情报
  • 保存到 Notion：直接将页面保存到 Notion
  • React Agent：使用 Google 搜索和 API 功能解决任务

设置

1. 修改根目录下的 env.example.ts 文件，将其重命名为 env.ts 并设置其中的变量：

考虑到您还需要从服务器环境（在 Claude Desktop 配置中）访问这些变量，使用常规的 .env 文件似乎过于复杂。 如果您找到更好的解决方案，请再考虑使用 .env 文件。

• 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，请按照此处的说明进行操作。

如果您不想使用这 4 个工具中的任何一个，您可以将相应的环境变量留空，该工具将不会被注册。

2. 安装依赖项并构建服务器：

npm install
npm run build-server

3. 使用 Claude for Desktop 测试服务器

您需要安装 Claude for 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 工具
• 更好地支持复杂的块（例如“询问人类”块）
• 更好地处理工具调用的错误