magatama - AI Coding Support MCP Server

MAGATAMA（YATA のフォーク）の MCP サーバーパッケージです（PyPI 配布名 magatama / import 名 magatama_mcp / CLI コマンド magatama）。

Model Context Protocol (MCP) サーバーとして、AI コーディングツールに知識グラフコンテキストを提供します。

特徴

• 🤖 MCP 完全対応: 36 Tools, 3 Prompts, 1 Resource
• 🔌 comP Bridge: comP の .comp/index.db を再パースなしで知識グラフに取り込み
• 🔌 AI ツール連携: Claude Desktop, GitHub Copilot, Cursor
• 📡 複数トランスポート: stdio / SSE
• 🔒 プライバシー: 完全ローカル実行

インストール

pip install magatama

使用方法

CLI コマンド

# ファイルを解析
magatama parse path/to/file.py

# ディレクトリを解析
magatama parse path/to/project --pattern "**/*.py"

# MCP サーバーを起動（stdio）
magatama serve

# MCP サーバーを起動（SSE）
magatama serve --transport sse --port 8080

# エンティティを検索
magatama query "function_name" --type function

# 統計情報を表示
magatama stats

# グラフの整合性を検証
magatama validate --graph graph.json --repair

AI ツール設定

Claude Desktop

{
  "mcpServers": {
    "magatama": {
      "command": "magatama",
      "args": ["serve"]
    }
  }
}

GitHub Copilot (VS Code)

.vscode/mcp.json:

{
  "mcpServers": {
    "magatama": {
      "command": "magatama",
      "args": ["serve"]
    }
  }
}

MCP Tools

全 36 ツールを提供します（基本・フレームワーク知識・検索・品質分析・ AI 支援・comP Bridge）。下表は基本ツールの抜粋で、全 36 ツールの一覧は ルート README を参照してください。

MCP Prompts

ライセンス

MIT License - 詳細は LICENSE を参照してください。

関連プロジェクト

• magatama-core - Knowledge Graph Engine