# 大山 CRM MCP 服务与 AI Agent Skill (`dashan-crm-mcp`)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)

大山 CRM 的标准 MCP (Model Context Protocol) 插件包，整合了完整的 CRM 工具集中线（客户、订单、产品、仓库、员工等）以及配套的 AI Agent 操作安全规范 `SKILL.md`。

---

## 📦 项目功能

1. **`crm-mcp` 服务**：实现标准的 Model Context Protocol (MCP) 接口，支持任何兼容 MCP 协议的 Agent (Hermes, Claude Desktop, Cursor, Windsurf, Codex 等)。
2. **`SKILL.md` 规范**：针对大山 CRM 的特定安全约束（先查再写、数据遮蔽、高危动作二次确认原因机制）。

---

## 🚀 快速快速部署指南

### 1. 安装与编译

在任意目标机器上执行：

```bash
git clone https://github.com/xuzhu03133-ai/dashan-crm-mcp.git
cd dashan-crm-mcp
pnpm install && pnpm build
```

### 2. 获取你的 Agent 密钥 (`CRM_AGENT_KEY`)

1. 登录大山 CRM 系统（生产域名：`https://bolai001.cn`）。
2. 在个人菜单选择 **Agent 密钥** 页面，点击生成并复制密钥（格式如 `agk_xxxx...`）。

---

## 🔧 客户端接入配置 (MCP Configuration)

### Hermes Agent 配置 (`mcp.json`)

在 Hermes 的 MCP 配置文件（如 `~/.hermes/mcp.json`）中添加以下内容：

```json
{
  "mcpServers": {
    "dashan-crm": {
      "command": "node",
      "args": [
        "/绝对路径/dashan-crm-mcp/dist/index.js"
      ],
      "env": {
        "CRM_BASE_URL": "https://bolai001.cn/api",
        "CRM_AGENT_KEY": "YOUR_CRM_AGENT_KEY_HERE"
      }
    }
  }
}
```

### Skill 提示词注入

将本仓库中的 `SKILL.md` 内容包含进 Hermes Agent 的 System Rules 或放置于 Hermes 的 Skills 文件夹中 (`~/.hermes/skills/dashan-crm-agent/SKILL.md`)。

---

## 📄 开源许可

[MIT License](LICENSE)