内容
🎫 MCP Movidesk 服务器
Movidesk 的 MCP（模型上下文协议）服务器，用于管理工单，基于 **TypeScript + Node.js** 构建。
允许 AI 代理直接在 Movidesk 中创建、查询、搜索和管理工单，无需手动访问平台。
---
## 📋 工具列表
| # | 工具 | 描述 |
|---|-----------|-----------|
| 1 | `criar_ticket` | 创建带有支持宏（服务/升级）的全新工单 |
| 2 | `consultar_ticket` | 按 ID 查找工单的完整详细信息 |
| 3 | `buscar_conhecimento` | 搜索已解决的工单作为知识库 |
| 4 | `adicionar_interacao` | 在现有工单中添加评论/操作 |
| 5 | `listar_tickets_cliente` | 按姓名/电子邮件/CPF/CNPJ 列出客户的工单 |
| 6 | `alterar_status_ticket` | 更改工单状态（新建、处理中、已解决等） |
| 7 | `atribuir_agente` | 将工单分配给代理或团队 |
---
## 🚀 安装
### 1. 安装依赖
```bash
cd c:\Users\Usuario\Documents\Mcp_Eagle
npm install
```
### 2. 配置 API 令牌
复制示例文件并插入您的令牌：
```bash
copy.example .env
```
编辑` 文件，将 `seuqui` 替换为您的实际令牌：
```
MOVIDESK_TOKEN=seu_token_real_aqui
```
> **在哪里找到令牌：** Movidesk > 配置 > 账户 > 参数 > 环境选项### 3. 编译项目
```bash
npm run```
---
## ⚙️ravity 配置
在您的 Antigravity `settings.json` 中添加以下配置：
```json
{
mcpServers": {
"mcp-movidesk": {
"command": "node",
"args": ["c:\\Users\\Documents\\Mcp_Eagle\\dist\\index.js"],
env": {
"MOVIDESK_TOKEN": "seu_token_aqui"
}
}
}
}
```
---
## 🧪 测试
运行所有测试：
```npm test
```
监听模式（保存时重新运行）：
```bash
npm run test:watch---
## Docker（Swarm & Portainer）
该项目通过 Portainer/Docker Swarm 轻松部署，支持 **Traefik** 和 Express 包的原生 HTTPS。
### 镜像构建
要创建优化的 Docker 镜像：
```bash
docker build -t mcp-movidesk-eagle:latest .
```
### Portainer 部署（Stacks）
1. 访问您的 Portainer。
2. 导航到 **Swarm > Stacks** 并点击 **Add stack**。
3. 复制 `docker-compose.yml` 文件的内容并粘贴到 Web 编辑器中。
4. 在 **Environment variables** 部分，添加带有您的实际令牌的 `MOVIDESK_TOKEN`。
5. 点击 **Deploy the stack**。
> 配置使用 **Traefik** 作为代理，并自动发布到 `https://mcp.wizeflowsolutions.com/mcp`。
---
## 🌐 远程配置（通过域名）
要将 MCP 工具用于支持通过 **域名（SSE - Server-Sent Events）** 连接的现代或云客户端，如 Dify、Flowise、Cursor 或 LangChain，您需要指定连接类型为远程。
这些配置的 JSON 格式：
```json
{
"mcpServers": {
"mcp-movidesk-cloud": {
"type": "sse",
"url": "https://mcp.wizeflowsolutions.com/mcp"
}
}
}
```
> **注意：** 对于纯本地且不适应 Web 读取的应用程序，请使用“Antigravity 配置”部分中提供的 CLI 方法。
---
## 📁 项目结构
```
src/
├── index.ts # 入口点（stdio 传输）
├── servidor-mcp.ts # 注册 7 种工具
├── cliente-movidesk/
│ ├── api.ts # 带有速率限制的 HTTP 客户端
│ └── tipos.ts # TypeScript 类型（接口/枚举）
├── ferramentas/
│ ├── criar-ticket.ts # 使用宏创建工单
│ ├── consultar-ticket.ts # 按 ID 查询工单
│ ├── buscar-conhecimento.ts # 知识库
│ ├── adicionar-interacao.ts # 添加交互
│ ├── listar-tickets.ts # 列出客户工单
│ ├── alterar-status.ts # 更改状态
│ └── atribuir-agente.ts # 分配代理
└── utilidades/
├── formatador-html.ts # Markdown → HTML
├── validacoes.ts # 验证（CPF, CNPJ, 电子邮件）
└── macros-suporte.ts # 宏的 HTML 模板
testes/
├── formatador-html.test.ts
├── validacoes.test.ts
├── api-cliente.test.ts
└── ferramentas.test.ts
```
---
## 🔧 开发
```bash
# 以开发模式运行（使用 tsx）
npm run dev
# 编译 TypeScript
npm run build
# 运行编译后的版本
npm start
```
---
## 📄 许可证
MIT
