cunkebao_v3/Moncter/MCP/moncter-mcp-server/README.md

Moncter MCP Server

Moncter MCP Server 是一个 Model Context Protocol (MCP) 服务器，用于通过 MCP 协议管理 Moncter 系统的数据采集任务和标签任务。

功能

提供以下 MCP 工具：

1. create_data_collection_task - 创建数据采集任务
2. create_tag_task - 创建标签计算任务
3. list_data_collection_tasks - 获取数据采集任务列表
4. list_tag_tasks - 获取标签任务列表
5. get_data_sources - 获取数据源列表
6. get_tag_definitions - 获取标签定义列表
7. start_data_collection_task - 启动数据采集任务
8. start_tag_task - 启动标签任务

安装

cd MCP/moncter-mcp-server
npm install
npm run build

配置

在 mcp.json 中配置服务器：

{
  "mcpServers": {
    "Moncter": {
      "command": "node",
      "args": ["E:/Cunkebao/Cunkebao02/Moncter/MCP/moncter-mcp-server/dist/index.js"],
      "env": {
        "MONCTER_API_URL": "http://127.0.0.1:8787"
      }
    }
  }
}

或者使用 npm 方式（如果全局安装）：

{
  "mcpServers": {
    "Moncter": {
      "command": "node",
      "args": ["./MCP/moncter-mcp-server/dist/index.js"],
      "cwd": "E:/Cunkebao/Cunkebao02/Moncter",
      "env": {
        "MONCTER_API_URL": "http://127.0.0.1:8787"
      }
    }
  }
}

环境变量

• MONCTER_API_URL: 后端API基础URL（默认: http://127.0.0.1:8787）

使用示例

创建数据采集任务

{
  "name": "create_data_collection_task",
  "arguments": {
    "name": "订单数据采集",
    "description": "从KR商城采集订单数据",
    "data_source_id": "your_data_source_id",
    "database": "KR_商城",
    "collection": "21年贝蒂喜订单整合",
    "mode": "realtime",
    "field_mappings": [
      {
        "source_field": "订单号",
        "target_field": "order_no"
      }
    ]
  }
}

创建标签任务

{
  "name": "create_tag_task",
  "arguments": {
    "name": "高价值用户标签计算",
    "description": "计算高价值用户标签",
    "task_type": "full",
    "target_tag_ids": ["tag_id_1", "tag_id_2"],
    "user_scope": {
      "type": "all"
    },
    "schedule": {
      "enabled": true,
      "cron": "0 2 * * *"
    }
  }
}

开发

# 开发模式（使用 tsx）
npm run dev

# 编译
npm run build

# 运行
npm start