Wordware Research

🚀 Wordware MCP 词典

这是一个基于模型上下文协议（MCP）的服务器，它将 Wordware 强大的代理功能与 Claude 等 MCP 兼容的 AI 助手完美集成，为 AI 助手提供专业的工具支持。

🚀 快速开始

该项目借助 Anthropic 的模型上下文协议（MCP），搭建起了像 Claude 这类 AI 助手与 Wordware 专业代理功能之间的桥梁。通过此集成，可依据配置动态加载来自 Wordware API 的工具，让 Claude 能够使用任何专业的 Wordware 流程。

✨ 主要特性

• 🔄 动态工具加载：依据配置自动从 Wordware API 加载工具。
• 🧠 智能模式检测：自动检测并适配不同工具的输入模式。
• 🔍 高级参数处理：可处理各类输入格式，如 JSON、嵌套结构、字符串等。
• ⚙️ 强大的错误处理：具备全面的错误日志记录和事件循环管理。
• 🔑 简单的身份验证：通过配置能轻松连接您的 Wordware 账户。

📦 安装指南

先决条件

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

安装步骤

# 克隆仓库
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安装依赖项
pip install -r requirements.txt

# 设置环境变量
cp .env.example .env
# 使用您的 Wordware API 凭据编辑 .env 文件

📚 详细文档

配置

创建一个 tools_config.json 文件，其结构如下：

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

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

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

运行服务器

# 使用默认设置运行
python server.py

# 以调试日志运行
python server.py --debug

# 在特定端口上以 SSE 传输运行
python server.py --transport sse --host 127.0.0.1 --port 8000

# 或在 Claude Desktop 中安装
mcp install python server.py --name "Wordware 工具"

工作原理

Wordware MCP 服务器按以下步骤运行：

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

高级功能

智能参数处理

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

• 直接参数：{"Full Name": "John Doe", "Company": "Tech Corp"}
• JSON 格式字符串："{\"Full Name\": \"John Doe\", \"Company\": \"Tech Corp\"}"
• 嵌套结构：[ {"name": "John Doe"}, {"company": "Tech Corp"} ]

工具注册

通过配置文件指定要注册的工具 ID，服务器将自动加载并注册这些工具。

运行时示例

# 示例配置文件 tools_config.json
{
  "tools": [
    {
      "id": "wordware_create_document"
    },
    {
      "id": "wordware_analyze_data"
    }
  ]
}

# 启动服务器
python server.py

# 现在工具已注册并可供 Claude 使用

📄 许可证

该项目采用 MIT 许可证，有关详细信息，请参阅 LICENSE 文件。

致谢

• Anthropic 提供了模型上下文协议。
• Wordware 提供了代理平台。
• MCP Python SDK 实现了协议。

贡献

欢迎贡献代码！请随时提交 Pull Request。