AI导哈

HTTP服务器工具

Simplicate MCP Server是一个基于HTTP的服务器工具，用于与Simplicate API进行交互，支持多种功能模块如工时管理、CRM、项目管理和HRM等。

  • by superdwayne
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 superdwayne/Simplicate_mcp

使用说明

简化版MCP服务器（xmcp HTTP）

快速入门

  1. 安装依赖项
npm install
  1. 设置环境变量（本地）
  • 创建一个 .env.local 与以下文件一起：
    • SIMPLICATE_API_BASE_URL=https://act.simplicate.com/api/v2
  • SIMPLICATE_API_SECRET=...
  1. 在本地运行
npm run dev

部署到Vercel（完全远程）

  1. 安装 Vercel CLI
npm i -g vercel
  1. 部署
vercel
  1. 在 Vercel 项目 → 设置 → 环境变量 中，添加：
  • SIMPLICATE_API_BASE_URL=https://act.simplicate.com/api/v2
  • SIMPLICATE_API_SECRET=...
  1. 重新部署并使用生产环境URL https://<project>.vercel.app 在全球范围内。

工具

  • 时间： list-hours， get-hour-by-id， create-hour-entry
  • CRM：客户关系管理 list-organizations， list-contacts
  • 项目： list-projects， list-activities， get-project， get-activity， list-project-phases， list-project-tasks， list-project-budgets
  • 人力资源管理（HRM）: list-employees
  • 信息： calendar-status
  • 分析： estimate-builder， historic-estimation-helper， skill-demand-forecast， total-project-hours， total-employee-hours， pending-approval-hours， project-hours-vs-budget， project-overview， project-risk-summary， organization-summary， employee-profile， hours-by-month， resource-capacity-check

在运行时传递API凭据

  • 客户端可以通过以下方式包含其Simplicate API密钥： Authentication-Key 在头部中指定以覆盖默认密钥；否则服务器将使用 SIMPLICATE_API_KEY。

参考文献

简化版_mcp

服务器令牌认证（推荐）

  • 通过环境变量设置服务器范围的令牌：
    • MCP_SERVER_TOKEN=...
  • 对于HTTP请求，服务器要求 MCP_SERVER_TOKEN 以及一个相匹配的 x-mcp-token 头球 缺少配置会导致500错误；缺少/不匹配的头部信息会导致401错误。
  • 对于本地stdio传输，不需要令牌。

示例HTTP请求头：

GET /tools/hours/list-hours HTTP/1.1
Host: <your-host>
Authorization: Bearer <your-own-client-auth-if-any>
x-mcp-token: <MCP_SERVER_TOKEN>

简化API密钥处理

  • 默认键：配置 SIMPLICATE_API_KEY （建议用于服务器端）。
  • 按请求覆盖的头部 Authentication-Key 默认情况下已禁用。要启用，请设置：
    • ALLOW_KEY_OVERRIDE=true
  • 当禁用覆盖且没有 SIMPLICATE_API_KEY 如果配置不当，请求将会失败。

错误编辑（或错误修正）

  • 错误体对常见的PII/秘密字段进行遮蔽（例如。， email， phone， iban， token， secret， authentication-key）。

相关 MCP