🚀 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页面IDSAVE_TO_NOTION_APP_ID：您部署的“保存到Notion”应用的IDRESEARCH_FOUNDER_APP_ID：您部署的“研究创始人”应用的IDLEAD_ENRICHMENT_APP_ID：您部署的“领导丰富度”应用的IDREACT_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工具自动添加的部署。
- 更好地支持复杂块（例如“询问人类”块）。
- 提供更好的工具调用错误处理。