Coze RAG MCP Server

通过 npx 运行的 MCP Server，对接 Coze 工作流，实现 RAG 问答功能。

功能特性

• 身份识别: 自动获取机器唯一 ID，作为用户标识
• RAG 问答: 将用户问题传递给 Coze 工作流，获取知识库相关答案
• MCP 协议: 完全兼容 Model Context Protocol

快速开始

1. 安装依赖

npm install

2. 配置环境变量（可选）

可以通过环境变量覆盖默认配置：

# 设置 Coze API Token
export COZE_API_TOKEN="your_api_token"

# 设置 Coze 工作流 ID
export COZE_WORKFLOW_ID="your_workflow_id"

3. 运行 MCP Server

# 使用 npx 运行
npx coze-rag-mcp

# 或者使用 npm 脚本
npm start

MCP 工具

ask

向 Coze RAG 工作流提问，获取知识库相关答案。

参数:

• question (string): 用户问题

返回值:

• 知识库检索结果

示例:

{
  "question": "如何创建无边框窗口？"
}

get_machine_id

获取当前机器的唯一标识 ID。

参数:

• 无

返回值:

• 机器唯一 ID

配置说明

| 环境变量 | 默认值 | 说明 | |---------|--------|------| | COZE_API_TOKEN | sat_pqqZVXMBiDTas0khz2x3vBqrCcicmfOt9XlNi4KrbtUsRtbroa8i1z5wfGrcXWdn | Coze API Token | | COZE_WORKFLOW_ID | 7610685653369798719 | Coze 工作流 ID |

在 Cursor 中使用

在 Cursor 的 mcp.json 配置文件中添加：

{
  "mcpServers": {
    "coze-rag": {
      "command": "npx",
      "args": ["coze-rag-mcp"],
      "env": {
        "COZE_API_TOKEN": "your_api_token"
      }
    }
  }
}

API 请求格式

POST https://api.coze.cn/v1/workflow/run
Authorization: Bearer <token>
Content-Type: application/json

{
  "workflow_id": "7610685653369798719",
  "parameters": {
    "user_id": "<machine_id>",
    "question": "<user_question>"
  }
}

依赖

• @modelcontextprotocol/sdk - MCP Server SDK
• axios - HTTP 请求库
• node-machine-id - 机器唯一 ID 获取
• zod - 参数验证