AI导哈

Cacoo MCP服务器

一个非官方的Cacoo Model Context Protocol (MCP)服务器，为AI编码代理如Claude Code和Cursor提供读取Cacoo图表图像和元数据的工具。

  • by mahito1594
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mahito1594/cacoo-mcp

使用说明

@马希托1594/cacoo mcp

README:日本语| 英语

卡库 非公式 模型上下文协议（MCP） 服务器。提供只读工具，允许AI编码代理（如Claude Code或Cursor）直接浏览Cacoo图中的图像和元数据。

安装，安装

1.获取Cacoo API密钥

Cacoo帐户设置对较大场景进行渲染期间已观察到该故障。

2.设置MCP客户端

克劳德代码：请执行以下命令

claude mcp add --env CACOO_API_KEY=your-api-key-here cacoo-mcp -- npx -y @mahito1594/cacoo-mcp

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 或 %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "cacoo-mcp": {
      "command": "npx",
      "args": ["-y", "@mahito1594/cacoo-mcp"],
      "env": {
        "CACOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

光标 (.cursor/mcp.json):

{
  "mcpServers": {
    "cacoo-mcp": {
      "command": "npx",
      "args": ["-y", "@mahito1594/cacoo-mcp"],
      "env": {
        "CACOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

环境变数

变数名 必须 说明
CACOO_API_KEY ｜必需｜Cacoo API键｜
CACOO_ORGANIZATION_KEY 可选/默认组织密钥。如果省略了，请先 list_organizations 中所述修改相应参数的值。

工具

工具名称｜说明｜ | -------------------- | ---------------------------------------------------------- | | list_organizations 获取设置的API密钥中可用的Cacoo组织列表 | list_diagrams 取得图的一览（也可以在关键字和文件夹中缩小范围） | get_diagram_sheets 获取图中包含的图纸列表（图纸ID和名称） | get_diagram_image 通过Base64编码获取图中的PNG图像

典型使用流程

list_organizations()                    # CACOO_ORGANIZATION_KEY が未設定の場合
list_diagrams(keyword?)                 # diagramId を特定し sheetCount を確認
  if sheetCount > 3:
    get_diagram_sheets(diagramId)       # sheetId を取得
get_diagram_image(diagramId, sheetId?)  # 画像を取得

sheetId 对话框，您可以在此定义自定义格式get_diagram_image 并行检索所有工作表。

开発

Node.js>=22和 pnpm >=10。 布置 中所述修改相应参数的值。

pnpm install
pnpm build       # TypeScript をコンパイル → dist/index.mjs
pnpm test        # テストを実行
pnpm typecheck   # 型チェック（出力なし）
pnpm lint        # oxlint を実行

代理技能

此项目使用以下第三方代理技能：。

请使用以下命令安装。

pnpm dlx skills experimental_install

许可证

麻省理工学院

相关 MCP