personaleasy-mcp-server

PersonalEasy | EasyDental Cloud | DentalKids API 的 MCP 服务器。

工具

所有工具均为只读 (readOnlyHint: true)。

Related MCP server: open-dental-mcp

安装

npm install
npm run build

凭据

凭据永不存储在代码中。通过环境变量配置：

• PERSONALEASY_API_KEY — API 密钥 (请求头 x-api-key)

• PERSONALEASY_CLIENT_ID — 客户端 ID

• PERSONALEASY_BASE_URL — 可选，默认值为 https://prsrb.onrender.com/v1/rpc

本地测试时，将 .env.example 复制为 .env 并填写。.env 已在 .gitignore 中——不要对其进行版本控制或共享。

在 Claude Code 中配置

claude mcp add personaleasy --env PERSONALEASY_API_KEY=SUA_KEY --env PERSONALEASY_CLIENT_ID=SEU_CLIENT_ID -- node D:/MCPS/personaleasy-mcp-server/dist/index.js

在 Claude Desktop 中配置

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "personaleasy": {
      "command": "node",
      "args": ["D:/MCPS/personaleasy-mcp-server/dist/index.js"],
      "env": {
        "PERSONALEASY_API_KEY": "SUA_KEY",
        "PERSONALEASY_CLIENT_ID": "SEU_CLIENT_ID"
      }
    }
  }
}

在 Easypanel (Docker) 上部署

该项目有两种运行模式：

• stdio (dist/index.js) — 本地使用 (Claude Code / Claude Desktop)

• HTTP (dist/http.js) — 远程使用；这是 Dockerfile 使用的模式

在 Easypanel 中，创建一个指向此仓库的 App 类型服务（通过 Dockerfile 构建）并配置环境变量：

在服务中暴露端口 3000。端点：

• POST /mcp — MCP 端点 (Streamable HTTP, 无状态)

• GET /health — 健康检查

生产环境实例

• 基础 URL： https://dk-projetos-mcps.nv8gf3.easypanel.host

• 健康检查： GET https://dk-projetos-mcps.nv8gf3.easypanel.host/health → {"status":"ok"}

• MCP 端点： POST https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp

将 MCP 客户端连接到此实例：

claude mcp add --transport http personaleasy https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp --header "Authorization: Bearer SEU_MCP_AUTH_TOKEN"

将 SEU_MCP_AUTH_TOKEN 替换为在 Easypanel 服务的 MCP_AUTH_TOKEN 变量中配置的值。

重要提示： 如果服务未配置 MCP_AUTH_TOKEN，任何拥有此 URL 的人都可以查询诊所数据。请确认该变量在生产环境中已设置。

底层 API

所有调用均发送至单个 RPC 端点：

POST {BASE_URL}
Headers: x-api-key
Body: { "clientId": "...", "method": "RPCGet...", "params": { ... } }

使用的方法：RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento。