@马希托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和 >=10。 布置 中所述修改相应参数的值。
pnpm install
pnpm build # TypeScript をコンパイル → dist/index.mjs
pnpm test # テストを実行
pnpm typecheck # 型チェック（出力なし）
pnpm lint # oxlint を実行代理技能
此项目使用以下第三方代理技能：。
- 上下文提交 由疯狂破坏者-麻省理工学院许可证
请使用以下命令安装。
pnpm dlx skills experimental_install