# Moncter MCP 集成

这个目录包含 Moncter 系统的 MCP (Model Context Protocol) 服务器实现。

## 目录结构

```
MCP/
├── mcp.json                    # MCP 服务器配置文件（需要配置路径）
├── mcp.json.example            # MCP 配置文件示例
├── moncter-mcp-server/         # Moncter MCP 服务器源代码
│   ├── src/
│   │   └── index.ts           # 服务器主文件
│   ├── package.json           # Node.js 依赖配置
│   ├── tsconfig.json          # TypeScript 配置
│   ├── install.sh             # Linux/Mac 安装脚本
│   ├── install.bat            # Windows 安装脚本
│   └── README.md              # 服务器详细文档
├── 快速开始.md                 # 快速开始指南
└── MCP服务器使用说明.md        # 详细使用说明
```

## 快速开始

1. **安装 MCP Server**

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

2. **配置 MCP 客户端**

   编辑 `MCP/mcp.json`，将 `YOUR_PROJECT_PATH` 替换为实际的项目路径。

3. **启动后端服务**

   ```bash
   php start.php start
   ```

4. **使用 MCP 工具**

   在支持 MCP 的 AI 客户端（如 Claude Desktop）中使用 Moncter MCP 服务器提供的工具。

## 可用的 MCP 工具

- `create_data_collection_task` - 创建数据采集任务
- `create_tag_task` - 创建标签计算任务
- `list_data_collection_tasks` - 获取数据采集任务列表
- `list_tag_tasks` - 获取标签任务列表
- `get_data_sources` - 获取数据源列表
- `get_tag_definitions` - 获取标签定义列表
- `start_data_collection_task` - 启动数据采集任务
- `start_tag_task` - 启动标签任务

## 文档

- [快速开始指南](./快速开始.md) - 安装和配置步骤
- [详细使用说明](./MCP服务器使用说明.md) - 完整的工具说明和使用示例
- [服务器 README](./moncter-mcp-server/README.md) - 服务器开发文档

## 注意事项

1. 确保 Node.js 版本 >= 18
2. 确保后端服务运行在配置的端口（默认 8787）
3. 配置文件中的路径需要根据实际情况修改
4. MCP 工具调用会直接操作后端API，请确保权限控制