wordware-mcp

基本能力

产品定位

Wordware MCP 服务器是一个本地开发工具，旨在将 Wordware 的 AI 能力集成到本地开发环境中，方便开发者测试和开发应用程序。

核心功能

1. 本地运行 Wordware 应用：支持在本地环境中运行 Wordware 应用程序。
2. 自动工具发现：无需指定 APP_ID，工具可自动发现。
3. 交互式安装：通过 npx wordware-mcp 提供交互式安装过程。
4. Claude 配置自动设置：支持自动配置 Claude 集成。
5. 命令行参数支持：提供丰富的命令行参数选项。
6. API 密钥直接指定：支持通过命令行参数直接指定 API 密钥。
7. 错误处理和日志增强：改进的错误处理和日志记录功能。
8. 全局安装支持：支持全局安装，简化命令语法。

适用场景

1. 本地开发：在本地环境中开发和测试 Wordware 应用程序。
2. AI 流程集成：将 Wordware 的 AI 流程集成到现有应用程序中。
3. 快速原型开发：利用 Wordware 的 AI 能力快速构建原型。
4. 与 Claude 集成：与 Claude 桌面应用集成，扩展功能。

使用教程

使用依赖

1. Wordware 账户：需要注册 Wordware 账户（wordware.ai）。
2. Wordware API 密钥：需要获取 Wordware API 密钥。
3. 已部署的 Wordware 应用：至少需要一个已部署的 Wordware 应用。

安装教程

交互式安装

npx wordware-mcp

永久安装

# 全局安装
npm install -g wordware-mcp

# 本地安装
npm install wordware-mcp

# 克隆仓库并全局安装
git clone https://github.com/{username}/wordware-mcp.git
cd wordware-mcp
npm run install-global

调试方式

启动 MCP 服务器

npx wordware-mcp start

检查服务器运行状态

lsof -i :3000

重启服务器并启用详细日志

npx wordware-mcp start --verbose

常见问题解答

1. 命令未找到：确保已全局安装并检查 npm 全局路径是否在 PATH 中。
2. 配置问题：检查 .env 文件是否存在或手动通过命令行参数指定配置。
3. 连接拒绝错误：检查服务器是否运行并尝试重启。
4. 权限问题：使用 sudo 临时解决或修复 npm 权限。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。