MCP Activities X

MCP活动

一种模型上下文协议（MCP）服务器，允许Cursor与meupontoline系统交互以创建活动。该服务器部署在Railway上，支持本地开发和云部署。

特性

• 创建具有开始日期、结束日期和描述的活动
• 根据meupontoonline API格式自动进行DTO转换
• 向meupontoonline API提交表单数据
• 用于云部署的HTTP传输
• TypeScript开发支持

安装

1. 克隆或下载此项目
2. 安装依赖项：

npm install

用法

运行MCP服务器

本地开发

在开发模式下启动服务器：

npm run dev

或者以生产模式启动：

npm start

铁路部署

服务器部署在Railway上，可通过HTTP传输访问。

光标集成

要将此MCP服务器与Cursor一起使用，请执行以下步骤：

方法1：铁路部署（推荐）

1. 打开的游标
2. 前往设置→ 特性→ 模型上下文协议
3. 使用此配置添加新服务器：

{
   "mcpServers": {
      "mcp-activities-x": {
         "url": "https://mcp-activities-x.up.railway.app/mcp"
      }
   }
}

方法二：地方发展

对于本地开发，请使用以下配置：

{
   "mcpServers": {
      "mcp-activities-x": {
         "url": "http://localhost:3000/mcp"
      }
   }
}

故障排除

• 用于铁路部署：确保URL正确并且服务器正在运行
• 为了地方发展：确保Node.js已安装并可从PATH访问
• 验证文件路径是否适用于您的系统
• 检查所有依赖项是否已安装 npm install
• 添加配置后重新启动Cursor
• 用以下方式构建项目 npm run build 在本地运行之前

可用工具

创建活动

在meupontoline系统中创建新活动。

参数：

• startDate （字符串，必填）：ISO格式的开始日期和时间（YYYY-MM-DDHH:MM:ss或YYYY-MM-MM-DD HH:MM）
• endDate （字符串，必填）：ISO格式的结束日期和时间（YYYY-MM-DDHH:MM:ss或YYYY-MM-MM-DD HH:MM）
• project （字符串，必填）：项目名称
• description （字符串，必填）：活动描述
• email （string，必填）：meupotonline的登录电子邮件
• password （string，必填）：meupotonline的登录密码

Cursor中的示例用法：

Create an activity from 2025-01-15 09:00 to 2025-01-15 17:00 for project "Frontend Development" with description "Component Implementation" using email "user@example.com" and password "password123"

DTO转型

服务器会自动将用户输入转换为所需的DTO格式：

输入：

• 开始日期： 2025-01-15T09:00:00
• 结束日期： 2025-01-15T17:00:00
• 说明： "Project Development - Frontend Implementation"

已转换的DTO：

{
   "dataLancamento": "2025-01-15 09:00",
   "horarioInicio": "09:00:00",
   "horarioFim": "17:00:00",
   "observacao": "",
   "idTarefa": 233,
   "detalheTarefa": "Project Development - Frontend Implementation"
}

认证

服务器需要身份验证才能访问meupontoonline API。登录过程：

1. 登录请求：将凭据发送到 https://app.meupontoonline.com/Login/RealizaLogin
2. Cookie提取：从响应中提取身份验证Cookie
3. 会话管理：对后续API请求使用Cookie

所需凭据：

• email：您的登录邮箱
• password：您的登录密码

API集成

服务器将转换后的DTO作为表单数据发送到：

• 网址： https://app.meupontoonline.com/Lancamentos/Create
• 方法： 发布
• 内容类型： 多部分/表单数据
• 认证：使用登录会话中的Cookie

错误处理

该服务器包括全面的错误处理功能，用于：

• 缺少必要参数
• 日期格式无效
• 结束日期早于开始日期
• 身份验证失败（凭据无效）
• API请求失败
• 网络错误
• 会话过期

发展

项目结构

mcp-activities-x/
├── src/
│   ├── index.ts          # Main MCP server implementation (TypeScript)
│   └── tools/            # Tool implementations
├── dist/                 # Compiled JavaScript output
├── dto-template.json     # DTO template reference
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

脚本

• npm run build：将TypeScript编译为JavaScript
• npm run dev：以热重载的开发模式运行
• npm start：运行编译版本
• npm run dev:watch：运行时查看文件

依赖项

• @modelcontextprotocol/sdk：MCP服务器框架
• express：HTTP服务器框架
• axios：API请求的HTTP客户端
• typescript：TypeScript编译器
• tsx：TypeScript执行环境

作者

拉斐尔·阿尔维斯