Back to Directory/Developer Tools

io.github.AvatarGaia/canvas-mcp

TeamAgent Canvas MCP(服务端 0.4.0):91 个工具——开岗、改配置、跑动作、看数据、发布并配知识库。可匿名试用,带 Key 解锁全部。

Developer ToolsJavaScriptv0.1.4

@avatargaia/canvas-mcp

stdio 马甲:让只支持 stdio 的 MCP 客户端(Claude Desktop / Cursor / 各类本地 Agent)接入 TeamAgent 的 Canvas MCP(streamable-http)。 纯转调,无状态、不缓存、不改写请求。

用

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"],
      "env": {
        "CANVAS_MCP_URL": "https://agent.avatargaia.top/api/mcp/canvas",
        "CANVAS_MCP_TOKEN": "ta_xxxxxxxx"
      }
    }
  }
}

环境变量

变量必填说明
CANVAS_MCP_TOKEN是ta_(平台令牌)或后续 dk_(开发者 Key)
CANVAS_MCP_URL否默认官方端点;自建部署时改这里
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":"you@example.com"}'
# → 返回 dk_ Key(只显示一次)+ 20 credits + 接入信息

收录

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @avatargaia/canvas-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-avatargaia-canvas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@avatargaia/canvas-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@avatargaia/canvas-mcpnpm

Compatible MCP Clients

io.github.AvatarGaia/canvas-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More