Wordware MCP
模型上下文协议 (MCP) 服务器将 Wordware 强大的代理功能与 Claude 和其他兼容 MCP 的 AI 助手相集成。
概述
该项目通过 Anthropic 的模型上下文协议 (MCP)，在 Claude 等 AI 助手与 Wordware 的专业代理功能之间架起了一座桥梁。该集成会根据配置动态加载 Wordware API 中的工具，从而使 Claude 能够访问任何专业的 Wordware 流程。
Related MCP server: Wordware MCP Server
特征
🔄 动态工具加载- 根据配置自动从 Wordware API 加载工具
🧠 智能模式检测- 自动检测并适应不同的工具输入模式
🔍 高级参数处理- 处理各种输入格式（JSON、嵌套结构、字符串）
⚙️ 强大的错误处理- 全面的错误日志记录和事件循环管理
🔑 简单身份验证- 轻松设置以连接您的 Wordware 帐户
先决条件
Python 3.8+
Wordware API 凭证
Claude Desktop 或其他 MCP 兼容客户端
安装
配置
创建具有以下结构的tools_config.json文件：
您可以在此配置文件中指定任何 Wordware 工具 ID，服务器将动态加载并将其注册为 MCP 工具。工具元数据（包括输入架构和描述）将直接从 Wordware API 获取。
要指定自定义配置文件路径，请使用CONFIG_PATH环境变量。
运行服务器
工作原理
Wordware MCP 服务器的操作如下：
工具配置加载- 从配置文件中读取工具 ID 列表
动态工具注册- 对于每个工具 ID：
从 Wordware API 获取元数据
检测输入架构要求
创建相应的 MCP 工具函数
将工具注册到 MCP 服务器
请求处理- 当调用工具时：
处理各种格式的输入参数（JSON 对象、字符串、嵌套结构）
根据工具要求调整参数格式
将正确格式的请求发送到 Wordware API
响应处理- 处理 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