@avatargaia/canvas-mcp
stdio 马甲：让只支持 stdio 的 MCP 客户端（Claude Desktop / Cursor / Cline / 各类本地 Agent）接入 TeamAgent 的 MCP 服务器（streamable-http）。纯转调，无状态、不缓存、不改写请求。
两个门，同一把 Key：
| 门 | 端点 | 工具 | 鉴权 |
|---|---|---|---|
| Canvas | https://agent.avatargaia.top/api/mcp/canvas |
13 个（岗位/动作/异步任务/统计） | 可不带 Key：匿名沙箱开放免费工具；带 dk_/ta_ 解锁全部 |
| AICare | https://agent.avatargaia.top/api/mcp/aicare |
7 个（AI 健康检测 13 类：舌苔/面部/指甲…） | 必须带 Key，按次计费 |
自动安装说明（给 Agent 读）：llms-install.md ｜ 隐私政策与支持：https://agent.avatargaia.top/privacy
用
CANVAS_MCP_URL=https://agent.avatargaia.top/api/mcp/canvas \
CANVAS_MCP_TOKEN=ta_xxxxxxxx \
npx -y @avatargaia/canvas-mcp
客户端配置（Claude Desktop claude_desktop_config.json 为例）：
{
"mcpServers": {
"teamagent-canvas": {
"command": "npx",
"args": ["-y", "@avatargaia/canvas-mcp", "--token", "dk_xxxxxxxx"]
}
}
}
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
CANVAS_MCP_TOKEN |
否 | dk_（开发者 Key）或 ta_（平台令牌）；不带 = 匿名沙箱，只能用免费工具 |
CANVAS_MCP_URL |
否 | 默认 Canvas 门；AICare 门填 https://agent.avatargaia.top/api/mcp/aicare；自建部署时改这里 |
CANVAS_MCP_KEY |
否 | CANVAS_MCP_TOKEN 的别名 |
行为
- stdin/stdout 逐行 JSON-RPC 2.0；通知（无
id）不回包 - 上游 HTTP 错误原样透传成 JSON-RPC error（
401: Missing Authorization header/402: …/429: …），客户端能看见真正原因 - 上游返回 SSE 或 JSON 都能解析（取最后一条
data:） - stdin 关闭后等所有在途请求落地再退出
验证记录（2026-09-12）
initialize ✅ serverInfo teamagent-canvas 0.3.0
tools/list ✅ 13 个工具
tools/call ✅ list_my_staff 返回岗位列表
无令牌 ✅ {"error":{"code":-32000,"message":"401: Missing Authorization header"}}
mcporter 接入 ✅ 作为 stdio server 连上并调用成功
拿 Key（自助，30 秒）
外部 / 本地 Agent 无需 TeamAgent 账号：
curl -X POST https://agent.avatargaia.top/api/dev/register \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","email":"[email protected]"}'
# → 返回 dk_ Key（只显示一次）+ 20 credits + 接入信息
- 开发者入口（控制台 / 计费 / 错误码）：https://agent.avatargaia.top/developers
- 机器可读自描述（Agent 自发现首选）：
GET https://agent.avatargaia.top/api/dev
工具注解
每个工具都带 MCP annotations（readOnlyHint / destructiveHint / idempotentHint / openWorldHint），付费工具在描述里写明 credit 数，客户端可据此做二次确认。
收录
- 官方 MCP Registry：
io.github.AvatarGaia/canvas-mcp - 接入文档：https://agent.avatargaia.top/mcp/canvas.html ｜ LLM 索引：/llms.txt
