mcpField
A
Acme CRM example

Acme CRM example

本地服务
github.com开发工具05 天前更新
代码仓库访问官网

关于 Acme CRM example

Acme CRM example 是一个兼容 WireCat 的命令行工具示例，展示第三方工具如何接入 WireCat。它使用虚构 CRM 的合成数据，供集成演示，不用于管理真实 CRM。

主要功能

  1. 01登录令牌存储在操作系统密钥环
  2. 02同步组织、人员、交易和发票提案
  3. 03列出并查看交易与联系人
  4. 04提供 WireCat Desktop 清单
  5. 05包含 MCP 服务和 Agent 技能

适用场景

  1. 01了解社区命令行工具如何接入 WireCat
  2. 02使用合成记录测试 CRM 同步流程
  3. 03通过 Agent 命令查看交易和联系人

MCP 相关

命令行工具包含 MCP 服务，并提供以 JSON 输出 MCP 配置的命令。Agent 可借此运行同步及 CRM 读取命令。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "leemour-acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
启动命令npx -y @leemour/acme-crm-cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@leemour/acme-crm-cli0.3.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

acme-crm

@leemour/acme-crm-cli 是一个在 WireCatLabs 之外构建的 WireCat 兼容 CLI 示例。它连接的是 Acme CRM， 一个并不存在的服务：未设置 ACME_CRM_BASE_URL 时，CLI 会使用内置模拟服务作答，该服务仅保存合成数据（10 个组织、25 位人员、15 笔交易、8 张发票）。所有名称都是虚构的，所有地址都位于 example.com。可以用它了解第三方工具如何接入 WireCat，而不是用它管理真实的 CRM。

它展示了真实工具所需的各个部分：

  • 使用 session start 登录，令牌保存在操作系统的密钥环中；
  • sync 通过 cli-core 的 CRM 接口复制组织、人员和交易，并通过 records 信封导入发票，作为 invoice: 提案由所有者在 WireCat 中确认；
  • 声明了效果并以 JSON 格式输出的读取命令：deals list、deals show、contacts list、contacts show；
  • WireCat Desktop 读取的清单 contracts/wirecat.json，以及 MCP 服务和 Agent 技能。

安装

WireCat Desktop 计划在工具所有者启用后，接入尚未检查过的社区工具，例如 @leemour/acme-crm-cli；它会检查软件包的来源记录，该记录仅由通过 release.yml 发布的版本提供。 在此之前，请从终端安装：

npm install -g @leemour/acme-crm-cli

登录一个配置文件。模拟服务接受任何以 acme_test_ 开头的令牌，例如 acme_test_demo：

acme-crm personal session start
acme-crm personal sync
acme-crm personal deals list status:open

每条使用账户的命令都必须指定其配置文件（上面是 personal）。该工具绝不会替你选择。

Agent 用法

acme-crm skill install --for claude
acme-crm personal mcp config --json

例如，Agent 随后会运行：

acme-crm personal sync --json
acme-crm personal deals list status:won --json=ref,title,amount,currency
acme-crm personal contacts show per_01 --json

开发

pnpm install
pnpm test
pnpm generate

设计文档位于 docs/dev/DESIGN.md。bin/first-publish 用于手动发布首个版本；后续版本则通过使用 npm 可信发布的 .github/workflows/release.yml 发布。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。