cantrip

mcp-server-cantrip

Cantrip 通过结构化的 GTM 工作流，帮助技术创始人找到首批客户。

• 明确你的 ICP — 定义理想客户画像、买家痛点和价值主张
• 研究竞争对手 — 梳理市场格局，找到你的制胜机会
• 获取下一步行动 — 差距分析会准确指出你该做什么，然后替你完成

适用于 Claude Code / Claude Desktop / Cursor — 以及任何兼容 MCP 的 Agent。

快速开始

1. 在 cantrip.ai 获取 API 密钥（设置）
2. 添加服务：

claude mcp add cantrip -e CANTRIP_API_KEY=your-api-key -- npx -y mcp-server-cantrip

3. 试试这个提示词：

“为我的产品初始化一个 Cantrip 项目：[用一句话描述你的产品]”

配置

上面的快速开始命令适用于 Claude Code。运行 claude mcp list 或在会话中使用 /mcp 命令，验证配置是否生效。

Claude Desktop / Cursor / 手动配置 JSON

所有 MCP 客户端使用相同的 JSON 代码块。将其添加到相应的配置文件中：

客户端	配置文件
Claude Code（手动配置）	~/.claude.json
Claude Code（项目范围）	项目根目录中的 .mcp.json
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）

{
  "mcpServers": {
    "cantrip": {
      "command": "npx",
      "args": ["-y", "mcp-server-cantrip"],
      "env": {
        "CANTRIP_API_KEY": "your-api-key"
      }
    }
  }
}

注意： 必须使用 -y 标志 — 否则 npx 会请求确认，并在 stdio 上一直等待。

Windows（非 WSL）： 使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "mcp-server-cantrip"]。

团队使用项目范围配置： 在 env 值中使用 "${CANTRIP_API_KEY}"，这样每位开发者都可以在自己的 shell 配置文件中设置密钥。

项目上下文（.cantrip.json）

每个项目目录都包含一个 .cantrip.json 文件，用于告知 Cantrip 目标项目：

{
  "project": "my-saas"
}

此文件由 cantrip_init（新项目）或 cantrip_connect（现有项目）自动创建。由 Agent 管理此文件 — 无需手动创建。

同一台机器上有多个项目？ 每个项目目录都有自己的 .cantrip.json。Agent 通过在正确的目录中工作来切换上下文。

Cantrip 使用示例

连接 Cantrip 后，按顺序尝试以下提示词：

1. “为我的产品初始化一个 Cantrip 项目：[用一句话介绍你正在构建的产品]”
2. “找出最可能的 ICP 和排名前 3 的买家痛点。”
3. “研究 5 个竞争对手，并告诉我有哪些制胜机会。”
4. “给我一份为期一周的 GTM 计划。”

故障排除

找不到服务 / 未显示工具：

• 运行 claude mcp list（Claude Code），或在会话中使用 /mcp 检查连接状态。
• 确认配置文件路径正确 — Claude Code 使用 ~/.claude.json 或 .mcp.json，而不是 ~/.claude/mcp.json。

服务启动时挂起：

• 确保 npx 参数中包含 -y。否则，npx 会等待交互式确认，而通过 stdio 永远无法收到确认。

出现“Cannot reach Cantrip API”错误：

• 确认在 MCP 配置的 env 块中设置了 CANTRIP_API_KEY。
• 检查你的网络能否访问 https://api.cantrip.ai。

Windows 出现“Connection closed”错误：

• 使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "mcp-server-cantrip"]。

架构

Agent (Claude, etc.) ── MCP protocol (stdio) ──> mcp-server-cantrip ── HTTPS POST ──> https://api.cantrip.ai

MCP 服务是一个轻量级转换层。它将 MCP 工具调用转换为 {command, args, flags} JSON 信封，并通过 POST 请求发送到 Cantrip API。不包含任何业务逻辑 — 与 CLI 和 React UI 使用完全相同的契约。

工具（17 个）

设置

工具	描述
cantrip_connect	将工作区连接到项目（读取/写入 .cantrip.json）
cantrip_status	检查守护进程是否正在运行
cantrip_init	创建新项目并自动连接

核心命令

工具	描述
cantrip_snapshot	项目概览，深入查看实体类型
cantrip_next	列出差距分析机会
cantrip_next_prompt	为某个机会生成包含丰富上下文的大模型提示词
cantrip_next_run	为某个机会启动后台 Agent
cantrip_history	查询审计记录

审核

工具	描述
cantrip_review	列出待审核的条目
cantrip_review_accept	接受推断出的实体
cantrip_review_reject	拒绝推断出的实体
cantrip_review_resolve	解决升级事项
cantrip_review_dismiss	忽略升级事项

实体 CRUD（通用）

工具	描述
cantrip_entity_list	列出某种类型的实体
cantrip_entity_show	显示实体详情
cantrip_entity_add	创建新实体
cantrip_entity_edit	编辑现有实体

支持的实体类型：icp、pain_point、value_prop、experiment、channel、competitor、contact

许可证

MIT