garmonia-crm-mcp

用于通过其内部 API 测试「Harmony Hotel」CRM 的 MCP 服务器。 通过密码登录（会话 Cookie），提供订单、客户、品牌、日历等工具，以及对所有其他 CRUD 操作的通用访问。

快速安装（一条命令，无需克隆）

只需要 Node 18+。无需安装或克隆仓库——npx 会直接从 GitHub 启动服务器。

1. 创建本地凭据文件，例如 ~/garmonia-crm.json：

   {
     "baseUrl": "https://адрес-crm",
     "login": "твой-логин",
     "password": "твой-пароль"
   }

2. 用一条命令添加 MCP（替换为你自己的文件路径）：

   claude mcp add garmonia-crm \
     -e CRM_CONFIG="$HOME/garmonia-crm.json" \
     -- npx -y github:AlekseiKastsiuk/garmonia-crm-mcp

3. 重启 Claude Code。

凭据只保存在你的本地文件中，不会发送到任何地方—— npx 只是从 GitHub 拉取服务器代码。

Related MCP server: MCP CRUD Tools

从源码安装（替代方案）

git clone https://github.com/AlekseiKastsiuk/garmonia-crm-mcp
cd garmonia-crm-mcp
npm install
cp crm-config.example.json crm-config.json
# открой crm-config.json и впиши baseUrl, логин и пароль своей CRM

crm-config.json 包含 CRM 地址和登录名/密码，不要提交到 git （它已经在 .gitignore 中）。

连接到 Claude Code

在 ~/.claude.json 中（或通过 claude mcp add）添加服务器：

{
  "mcpServers": {
    "garmonia-crm": {
      "command": "node",
      "args": ["/полный/путь/к/garmonia-crm-mcp/server.mjs"]
    }
  }
}

如果配置文件不在服务器旁边，请在环境变量中指定路径：

"env": { "CRM_CONFIG": "/полный/путь/к/crm-config.json" }

修改后重启 Claude Code。

工具

安全说明

• CRM 地址和密码保存在 crm-config.json 中，该文件已被 .gitignore 忽略—— 不会进入仓库。

• crm-config.example.json 中只有占位符，没有真实数据。

• 首次提交前请检查：git ls-files 不应包含 crm-config.json， 而 git grep -i password 应只匹配到代码中的字段名。

注意事项

• 订单通过公开端点 POST /api/form-lead 创建——无需认证。

• 删除订单不是 REST 操作，而是 Next.js server action（即「已关闭」标签页上的「删除」按钮）。 crm_order_delete 直接调用该 action。action 的 ID 与前端构建绑定； 如果部署后删除失败，请更新 crm-config.json 中的 bulkDeleteActionId （在 JS bundle 中搜索 bulkDelete 即可找到）。

• 商品/分类的列表是通过服务端渲染返回的，而不是 GET API—— 如需创建/修改/删除，请使用 crm_request（POST/PATCH/DELETE）。