convez.ai
MCP Server
mahito1594

cacoo-mcp

mahito1594/cacoo-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

An unofficial MCP Server for Cacoo <https://cacoo.com>.

Instalação

$npx convez-ai mahito1594/cacoo-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
cacoo-mcp-v0.3.0
Issues abertas
2
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

@mahito1594/cacoo-mcp

README: 日本語 | English

Cacoo の非公式 Model Context Protocol (MCP) サーバーです。Claude Code や Cursor などの AI コーディングエージェントが Cacoo の図の画像やメタデータを直接参照できるよう、読み取り専用のツールを提供します。

セットアップ

1. Cacoo API キーを取得する

Cacoo のアカウント設定から API キーを生成してください。

2. MCP クライアントを設定する

Claude Code: 次のコマンドを実行してください

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

Claude Desktop (~/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 (.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図の PNG 画像を Base64 エンコードで取得する

典型的な使用フロー

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 が必要です。 mise を用いてインストールしてください。

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

Agent Skills

このプロジェクトは以下のサードパーティ Agent Skill を使用しています。

以下のコマンドでインストールしてください。

pnpm dlx skills experimental_install

ライセンス

MIT

Ver o original no GitHub

Bom para

Relacionados