123 lines
2.3 KiB
Markdown
123 lines
2.3 KiB
Markdown
|
# 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** - 启动标签任务
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd MCP/moncter-mcp-server
|
|||
|
|
npm install
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 配置
|
|||
|
|
|
|||
|
|
在 `mcp.json` 中配置服务器：
|
|||
|
|
|
|||
|
|
```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 方式（如果全局安装）：
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"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）
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
### 创建数据采集任务
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"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"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 创建标签任务
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"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 * * *"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 开发
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 开发模式（使用 tsx）
|
|||
|
|
npm run dev
|
|||
|
|
|
|||
|
|
# 编译
|
|||
|
|
npm run build
|
|||
|
|
|
|||
|
|
# 运行
|
|||
|
|
npm start
|
|||
|
|
```
|
|||
|
|
|