Integrations

Uses environment variables for configuration and authentication with Wordware API credentials

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 兼容客户端

安装

# Clone the repository
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your Wordware API credentials

配置

创建具有以下结构的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环境变量。

运行服务器

# Run with default settings
python server.py

# Run with debug logging
python server.py --debug

# Run with SSE transport on a specific port
python server.py --transport sse --host 127.0.0.1 --port 8000

# Or install in Claude Desktop
mcp install python server.py --name "Wordware Tools"

工作原理

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文件中正确设置
参数验证错误：验证输入格式是否符合工具的要求
事件循环错误：如果您看到“事件循环已关闭”错误，请尝试重新启动服务器

发展

要扩展或修改服务器：

# Run with debug logging
python server.py --debug

# Check the logs for detailed information
tail -f /path/to/your/logs/mcp.log

贡献

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

执照

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

致谢

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

模型上下文协议服务器将 Claude 等 AI 助手与 Wordware 的专门代理功能连接起来，允许通过标准化接口动态加载和访问任何 Wordware 流。