agentblueprint

Agent Blueprint 的 CLI 和 MCP 服务器 — 让您的编码智能体能够读取您的 AI 蓝图、商业案例、实施计划和规范。

CLI 快速入门

# Install globally
npm install -g agentblueprint

# Store your API token (one-time)
agentblueprint login

# List blueprints
agentblueprint list

# Get a blueprint summary (JSON to stdout)
agentblueprint get blueprint <id>

# Get other artifacts
agentblueprint get business-case <id>
agentblueprint get use-case <id>
agentblueprint get implementation-plan <id>
agentblueprint get implementation-spec <id>
agentblueprint get business-profile

# Download as Agent Skills directory
agentblueprint download <id>

# Partner cross-org access
agentblueprint list --org <customer-org-id>
agentblueprint get blueprint <id> --org <customer-org-id>

或者通过 npx 直接运行，无需安装：

npx agentblueprint list --token <your-api-key>
npx agentblueprint get blueprint <id> --token <your-api-key>

MCP 服务器设置

当 stdin 被管道传输（非交互式）时，同一二进制文件会自动检测 MCP 模式。无需单独的命令。

将其添加到您的 Claude Code MCP 配置（.claude/settings.json 或项目设置）中：

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": ["@agentblueprint/mcp-server"],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
      }
    }
  }
}

您也可以使用 agentblueprint serve 显式启动 MCP 服务器。

获取 API 密钥

前往 Agent Blueprint 设置 > API 令牌
点击“创建令牌”
复制令牌（仅显示一次）

将蓝图下载为 Agent Skills

将蓝图下载为本地 Agent Skills 目录，任何编码智能体都可以从文件系统读取该目录。这是使用蓝图的推荐方式。

# Using the CLI (after `agentblueprint login`)
agentblueprint download <id>
agentblueprint download <id> --dir ./my-skills

# Or via npx
npx agentblueprint download --token <key> --blueprint <id>

这将创建一个 Agent Skills 目录结构：

.agent-blueprint/<blueprint-slug>/
├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
├── references/
│   ├── business-context.md               # Use case, pain points, transformation story
│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
└── scripts/
    └── validate-spec.sh                  # Structure completeness checker

Agent Skills 标准受 Claude Code、Codex、Cursor、GitHub Copilot、Windsurf 以及其他 18 种以上的编码智能体支持。SKILL.md 在激活时自动加载（约 100 个 token），参考文件按需加载。

可用工具

工具	描述
`list_blueprints`	列出所有蓝图（摘要）
`get_blueprint`	蓝图摘要 — 标题、智能体、阶段、模式
`get_business_case`	商业案例摘要 — ROI、试点经济效益、建议
`get_implementation_plan`	实施计划摘要 — 史诗任务、时间表、故事点计数
`get_use_case`	蓝图的用例分析
`get_implementation_spec`	实施规范元数据
`get_business_profile`	组织业务概况
`download_blueprint`	将完整蓝图下载为 Agent Skills 文件清单

get_blueprint、get_business_case 和 get_implementation_plan 工具返回针对智能体上下文窗口优化的简洁摘要。如需完整详细信息（智能体规范、财务预测、用户故事），请使用 download_blueprint 获取完整的 Agent Skills 目录。

可用资源

URI	描述
`agentblueprint://blueprints`	蓝图列表 (JSON)
`agentblueprint://blueprints/{id}`	蓝图详情 (Markdown)
`agentblueprint://blueprints/{id}/spec`	实施规范 (Markdown)

身份验证

提供 API 令牌的三种方式（按此顺序检查）：

在任何命令中使用 --token <key> 标志
AGENT_BLUEPRINT_API_KEY 环境变量
agentblueprint login（保存到 ~/.config/agentblueprint/config.json）

环境变量

变量	必需	默认值	描述
`AGENT_BLUEPRINT_API_KEY`	否	—	您的 API 令牌（`agentblueprint login` 的替代方案）
`AGENT_BLUEPRINT_API_URL`	否	`https://app.agentblueprint.ai`	API 基础 URL

Agent Blueprint

agentblueprint

CLI 快速入门

MCP 服务器设置

获取 API 密钥

将蓝图下载为 Agent Skills

可用工具

可用资源

身份验证

环境变量

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API