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
|
||
```
|
||
|