Wordware MCP Server 使用说明

项目简介

Wordware MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它将 Wordware 平台上部署的工作流（flows）转化为可以在 Claude 等支持 MCP 协议的 LLM 应用中直接调用的工具。通过这个服务器，用户可以在 LLM 对话中利用 Wordware 强大的自动化和数据处理能力。

主要功能点

集成 Wordware 工具到 LLM: 将 Wordware 上部署的工作流作为工具注册到 MCP 服务器，使得 Claude 等 LLM 可以发现和调用这些工具。
预置常用工具: 内置了多个常用的 Wordware 工具，例如：
- Research Founder (创始人研究): 用于深入分析创始人信息，为会议准备提供全面的背景资料和问题。
- Lead Enrichment (线索丰富): 用于销售线索挖掘，收集个人和公司的关键信息，提供可执行的销售情报。
- Save to Notion (保存到 Notion): 直接将内容保存到用户的 Notion 页面。
- React Agent (React 智能体): 一个能够通过 Google 搜索、代码执行和 API 调用来解决复杂任务的智能代理。
可扩展性: 支持添加更多自定义的 Wordware 工作流作为工具，通过简单的配置即可扩展服务器的功能。

安装步骤

配置环境变量:
- 复制根目录下的 'env.example.ts' 文件，重命名为 'env.ts'。
- 根据 'env.ts' 中的注释，填写以下环境变量：
  - 'OPENAI_API_KEY': 你的 OpenAI API 密钥 (用于 'add-tool.ts' 脚本生成工具的 Zod Schema)。
  - 'NOTION_SECRET': 你的 Notion Secret (用于 "Save to Notion" 工具)。
  - 'NOTION_PARENT_PAGE_ID': 你希望保存页面到的 Notion 父页面 ID (用于 "Save to Notion" 工具)。
  - 'SAVE_TO_NOTION_APP_ID', 'RESEARCH_FOUNDER_APP_ID', 'LEAD_ENRICHMENT_APP_ID', 'REACT_AGENT_APP_ID': 你在 Wordware 上部署的对应应用的 App ID (可以在部署应用的 URL 中找到)。
- 如果你不需要使用某个预置工具，可以将其对应的环境变量留空，该工具将不会被注册。

安装依赖并构建服务器: 打开终端，进入项目根目录，运行以下命令：

npm install
npm run build-server

服务器配置

要将 Wordware MCP Server 集成到支持 MCP 的客户端（例如 Claude for Desktop），你需要配置客户端以连接到该服务器。以 Claude for Desktop 为例，你需要修改其配置文件 'claude_desktop_config.json'。

打开配置文件: 在终端运行以下命令（适用于 VSCode）：

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

添加服务器配置: 在 'claude_desktop_config.json' 文件中，添加 'mcpServers' 字段，并配置 Wordware 服务器。将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js' 替换为 'index.js' 文件的绝对路径。

{
  "mcpServers": {
    "wordware": {  // 服务器名称，可以自定义
      "command": "node", // 启动服务器的命令
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js"] // 启动命令的参数，指向服务器入口文件
    }
  }
}

注意: '/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js' 需要替换为你本地 'wordware' 项目 'build/index.js' 文件的实际绝对路径。

基本使用方法

配置完成后，重启 Claude for Desktop 等 MCP 客户端应用。客户端应该能够自动发现并连接到 Wordware MCP Server。

在 Claude 对话中，你可以通过自然语言指令来调用 Wordware 提供的工具。例如：

对于 "Research Founder" 工具，你可以说: '使用 research-founder 工具研究 Elon Musk 和 Tesla 公司，为即将到来的会议做准备。'
对于 "Save to Notion" 工具，你可以说: '使用 save-to-notion 工具将这段文字保存到 Notion，标题是 '会议纪要'，内容是 '今天的会议讨论了... ...''

具体的工具调用方式和参数会根据工具的描述和 Schema 定义在客户端中展示。

添加自定义工具 (可选)

仓库还提供了一个 'add-tool' 脚本，可以辅助你将更多自定义的 Wordware 工作流添加到 MCP 服务器中。具体使用方法请参考仓库 README 文件。

undefined

关键词

Wordware MCP Server 使用说明

信息