Wordware MCP

Wordware MCP

模型上下文协议 (MCP) 服务器将 Wordware 强大的代理功能与 Claude 和其他兼容 MCP 的 AI 助手相集成。

概述

该项目通过 Anthropic 的模型上下文协议 (MCP)，在 Claude 等 AI 助手与 Wordware 的专业代理功能之间架起了一座桥梁。该集成会根据配置动态加载 Wordware API 中的工具，从而使 Claude 能够访问任何专业的 Wordware 流程。

特征

• 🔄 动态工具加载- 根据配置自动从 Wordware API 加载工具
• 🧠 智能模式检测- 自动检测并适应不同的工具输入模式
• 🔍 高级参数处理- 处理各种输入格式（JSON、嵌套结构、字符串）
• ⚙️ 强大的错误处理- 全面的错误日志记录和事件循环管理
• 🔑 简单身份验证- 轻松设置以连接您的 Wordware 帐户

先决条件

• Python 3.8+
• Wordware API 凭证
• Claude Desktop 或其他 MCP 兼容客户端

安装

配置

创建具有以下结构的tools_config.json文件：

您可以在此配置文件中指定任何 Wordware 工具 ID，服务器将动态加载并将其注册为 MCP 工具。工具元数据（包括输入架构和描述）将直接从 Wordware API 获取。

要指定自定义配置文件路径，请使用CONFIG_PATH环境变量。

运行服务器

工作原理

Wordware MCP 服务器的操作如下：

1. 工具配置加载- 从配置文件中读取工具 ID 列表
2. 动态工具注册- 对于每个工具 ID：
   • 从 Wordware API 获取元数据
   • 检测输入架构要求
   • 创建相应的 MCP 工具函数
   • 将工具注册到 MCP 服务器
3. 请求处理- 当调用工具时：
   • 处理各种格式的输入参数（JSON 对象、字符串、嵌套结构）
   • 根据工具要求调整参数格式
   • 将正确格式的请求发送到 Wordware API
4. 响应处理- 处理 Wordware API 响应：
   • 解析服务器发送事件（SSE）流
   • 收集所有输出值
   • 以用户友好的方式格式化 Claude 的响应

高级功能

智能参数处理

服务器自动处理不同的输入参数格式：

• 直接参数： {"Full Name": "John Doe", "Company": "Acme Inc."}
• kwargs 中的 JSON 字符串： {"kwargs": "{\"Full Name\": \"John Doe\", \"Company\": \"Acme Inc.\"}"}
• 嵌套参数： {"kwargs": {"Full Name": "John Doe", "Company": "Acme Inc."}}

输入模式检测

服务器分析每个工具的输入模式以确定正确的格式：

• 检测工具是否需要包装在kwargs对象中的参数
• 提取内部属性以获得更好的文档
• 自动适应每个工具的参数格式

错误处理和恢复

强大的错误处理包括：

• 事件循环监控和恢复
• 所有请求和响应的详细记录
• 优雅地处理 HTTP 错误和超时
• 用于故障排除的综合错误消息

故障排除

• 工具未显示在 Claude Desktop 中：确保服务器正在运行并在 Claude Desktop 设置中正确注册
• 身份验证错误：检查您的 Wordware API 密钥是否在.env文件中正确设置
• 参数验证错误：验证输入格式是否符合工具的要求
• 事件循环错误：如果您看到“事件循环已关闭”错误，请尝试重新启动服务器

发展

要扩展或修改服务器：

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 人类学模型上下文协议
• 其代理平台的Wordware
• 用于协议实现的MCP Python SDK