词 ware 文档

简介

词 ware 是一个用于运行和管理 Word AI 模型的工具。通过词 ware，你可以轻松地将你的 Word 应用程序与 AI 集成，并通过 HTTP 请求触发不同的 AI 流程。

词 ware 支持以下功能：

• 通过简单的 HTTP 请求调用不同的 Word 应用
• 热重载开发模式，方便快速迭代
• 支持与 Claude 桌面集成
• 灵活的配置和扩展

新功能

v1.0.0

• 发布词 ware 的第一个版本
• 增加了对 HTTP 请求的支持
• 初始版本支持基本的功能

安装方法

使用 npm 安装

你可以通过 npm 来安装词 ware：

npm install -g wordware-mcp

克隆仓库

如果你想要修改或贡献代码，可以克隆我们的仓库：

git clone https://github.com/yuhuangou/wordware-mcp.git
cd wordware-mcp
npm install

基本用法

配置和启动词 ware 服务

你可以通过以下命令来配置和启动词 ware 服务：

npx wordware-mcp

按照提示输入你的 Word API 密钥，完成配置后，可以通过以下命令启动服务：

npx wordware-mcp start

与应用集成

启动词 ware 服务后，你可以通过以下 URL 访问你的 Word 应用程序：

http://localhost:3000/api/run/{app_id}

例如，如果你的应用 ID 是 your-app-id，你可以通过以下 JavaScript 代码调用它：

async function callWordwareApp() {
  const response = await fetch("http://localhost:3000/api/run/your-app-id", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "您的提示语句",
      // 其他参数
    }),
  });

  const result = await response.json();
  console.log(result);
}

配置

环境变量

你可以在 .env 文件中设置以下环境变量：

• PORT - 设置服务运行的端口（默认：3000）
• WORD_API_KEY - 你的 Word API 密钥

与 Claude 桌面集成

要将词 ware 与 Claude 桌面集成，请按照以下步骤操作：

1. 确保你已经安装了 Claude 桌面应用
2. 修改 Claude 桌面配置文件 ~/Library/Application\ 支持/Claude/claude_desktop_config.json
3. 添加以下内容到配置文件中：

{
  "mcpServers": {
    "wordware": {
      "command": "wordware-mcp"
    }
  }
}

完整示例工作流

步骤 1: 配置和启动词 ware 服务

# 运行交互式配置
npx wordware-mcp

# 按照提示完成以下操作：
# - 输入你的 Word API 密钥
# - 配置 Claude 集成（如果需要）

# 配置完成后，启动服务
npx wordware-mcp start

步骤 2: 与应用集成

词 ware 服务启动后，你可以通过以下 URL 访问你的 Word 应用程序：

http://localhost:3000/api/run/{app_id}

例如，如果你的应用 ID 是 your-app-id，你可以通过以下 JavaScript 代码调用它：

async function callWordwareApp() {
  const response = await fetch("http://localhost:3000/api/run/your-app-id", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "您的提示语句",
      // 其他参数
    }),
  });

  const result = await response.json();
  console.log(result);
}

故障排除

问题：无法启动词 ware 服务

• 检查你的 Word API 密钥是否正确
• 确保你已经安装了最新的 Node.js 版本
• 查看控制台输出，获取更多错误信息

问题：无法调用应用

• 检查网络连接
• 确保词 ware 服务正在运行
• 查看浏览器的开发者工具中的控制台输出

许可证

词 ware 是根据 MIT 许可证发布的。查看 LICENSE 文件获取详细信息。

贡献代码

如果你对词 ware 感兴趣，欢迎贡献代码！请参考我们的 CONTRIBUTING.md 文件了解如何参与贡献。