eyeot ERP

⚡ 60 秒安装

pip install eyeot-mcp        # 1.  install the bridge
eyeot-mcp login              # 2.  authenticate via browser (OAuth Device Flow)

然后将以下内容粘贴到 Claude Desktop 配置中：

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp"
    }
  }
}

重启 Claude Desktop。完成。试着询问：“列出我最近的 5 张发票。”

配置位置 · macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json

🧩 这是什么？

eyeot ERP 提供约 600 项业务操作——CRM、销售、库存、维护、人力资源、财务、IT 服务管理、GED、RGPD 合规，以及 6 个 V2 市场模块（POS、配送与路线规划、招聘、BPM、现场服务、供应链）——并以 HTTPS 上的 MCP 工具形式提供。

但 Claude Desktop、Cursor 和大多数本地 Agent 只支持 stdio 上的 MCP。

eyeot-mcp 正是连接它们的缺失环节。

flowchart LR
    A["🤖 Claude Desktop<br/>Cursor / custom agent"] -- "JSON-RPC<br/>over stdio" --> B["📦 eyeot-mcp<br/>(this package)"]
    B -- "HTTPS POST<br/>Bearer token" --> C["🏢 eyeot ERP<br/>(your tenant)"]
    C -. "Auth · RBAC · audit<br/>multi-tenant isolation<br/>license guard" .-> C

    style A fill:#eef2ff,stroke:#6366f1,color:#1e293b
    style B fill:#f0fdf4,stroke:#10b981,color:#065f46
    style C fill:#fef3c7,stroke:#f59e0b,color:#78350f

桥接工具中不包含任何业务逻辑。 所有操作都在服务端完成——身份验证、RBAC、审计日志、许可证执行、多租户隔离、幂等性。这个 CLI 仅约 290 行 Python 标准库代码，10 分钟即可审计完毕。

🎯 你的 Agent 能做什么？

安装后，你的 MCP 客户端即可使用以下操作：

……还有约 590 项，可通过 OpenAPI 规范自动生成。

🔐 身份验证

两种模式，传输时使用相同的 Bearer 标头，服务端使用相同的 Authorization 装饰器。

eyeot-mcp login

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp",
      "env": { "EYEOT_TOKEN": "eyk_xxx_xxx" }
    }
  }
}

🛡️ 安全模型

本地凭据存储于 ~/.eyeot-mcp/config.json，文件模式为 0600（POSIX）。在 Windows 上，适用文件 ACL。不进行遥测，不会主动联系服务器。

🏗️ 自托管

使用 --base-url 将桥接程序指向任意 eyeot 部署：

eyeot-mcp --base-url https://erp.example.com login

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp",
      "args": ["--base-url", "https://erp.example.com"]
    }
  }
}

相同的协议、相同的身份验证，运行于你自己的基础设施。

📚 命令

🔧 工作原理（底层机制）

1. Claude Desktop 将 eyeot-mcp 作为子进程启动，并通过 stdin/stdout 管道交换 JSON-RPC 2.0 消息。
2. 对于从 stdin 收到的每一行，桥接程序都会将 JSON POST 到 ${base_url}/api/v1/mcp，并附带 Authorization: Bearer <token>。
3. HTTP 响应会原样写入 stdout，并以按行分隔的 JSON 格式封装。
4. 服务端使用 MCP 2024-11-05 协议，并根据 OpenAPI 规范自动生成约 600 个工具——initialize、tools/list 和 tools/call 的工作方式完全符合 MCP 客户端的预期。

桥接程序不保存状态。除了传输层之外，不进行协议转换。没有意外。

📖 资源

• 本软件包：语义化版本。主版本号递增可能会更改 CLI 标志或磁盘上的配置架构。
• MCP 协议：2024-11-05（由服务端协商）。
• ERP API：/api/v1（稳定）。不兼容的更改将通过 /api/v2 发布。

📄 许可证

MIT — 可自由分叉、打包、审计，并在此基础上构建。

eyeot ERP 后端是 Eyeot Software 的独立专有产品。此桥接工具采用开源方式，因此任何人都可以审计、分叉、打包到自己的发行版中，或将其作为构建自有 MCP 客户端的参考。