Kursk Ye Code2flow MCP Server

🚀 Code2Flow MCP サーバー

このプロジェクトは、code2flow コマンドラインツールを MCP (Model Context Protocol) サーバーにラッピングしたものです。AI アプリケーションが標準化された MCP プロトコルを通じてコード呼び出しグラフを生成し、アクセスできるようにします。

✨ 主な機能

• ソースコードを分析し、呼び出しグラフを生成する
• 複数のプログラミング言語（Python、JavaScript、Ruby、PHP）をサポートする
• MCP プロトコルでサービスを提供し、AI アプリとの統合が容易である
• 画像を PNG 形式で出力する
• バージョンチェックとコード複雑度分析機能を提供する

📦 インストール

インストール要件

• Python 3.7+
• Windows 11 またはその他のサポートされるオペレーティングシステム
• PowerShell またはその他のコマンドラインターミナル
• code2flow コマンドラインツールがインストールされていること

インストール手順

1. このリポジトリをクローンする

git clone https://github.com/kursk-ye/code2flow-mcp-server.git
cd code2flow-mcp-server

2. 仮想環境を作成し、アクティブ化する（推奨）

python -m venv venv
.\venv\Scripts\Activate.ps1  # PowerShell で

3. 依存関係をインストールする

pip install -r requirements.txt

4. code2flow コマンドラインツールをインストールする

pip install code2flow

💻 使用例

基本的な使用法

Python で直接実行する場合

1. MCP サーバーを起動する

python server.py

MCP ツールを使用する場合

1. MCP Inspector ツールを使用する

mcp dev server.py

2. Claude Desktop にインストールする

mcp install server.py

3. Cursor MCP 設定に追加する

"code2flow": {
  "command": "cmd",
  "args": [
    "/c",
    "python",
    "path/to/server.py"
  ]
}

高度な使用法

Python MCP クライアントを使用する例

import asyncio
from mcp.client import MCPClient

async def main():
    # サーバーに接続する
    client = MCPClient("http://localhost:8000")
    
    # 新しいセッションを作成する
    session = await client.create_session()
    
    # ツールを呼び出して呼び出しグラフを生成する
    result = await session.call_tool("generate_call_graph", {
        "source_paths": ["path/to/your/code"],
        "language": "Python"
    })
    
    # code2flow のバージョンをチェックする
    version = await session.call_tool("check_code2flow_version")
    
    # コードの複雑度を分析する
    complexity = await session.call_tool("analyze_code_complexity", {
        "source_paths": ["path/to/your/code"]
    })
    
    print(f"呼び出しグラフ生成結果: {result}")
    print(f"code2flow バージョン: {version}")
    print(f"コード複雑度分析結果: {complexity}")

asyncio.run(main())

📚 ドキュメント

利用可能なツール

サーバーは以下の MCP ツールを提供します：

1. generate_call_graph - コード呼び出しグラフを生成する
2. check_code2flow_version - code2flow のバージョンをチェックする
3. analyze_code_complexity - コードの複雑度を分析する

利用可能なリソース

サーバーは以下の MCP リソースを提供します：

1. help://code2flow - ヘルプドキュメント
2. languages://supported - サポートされる言語のリスト
3. call-graph://画像ID - 生成された呼び出しグラフ画像

構成オプション

呼び出しグラフを生成する際には、以下の構成オプションを使用できます：

• source_paths - 分析対象のソースファイルのパスを指定する
• language - コードの言語を指定する（Python、JavaScript、Ruby、PHP をサポート）

ファイル構造

このプロジェクトには以下のファイルが含まれています：

• server.py - メインのサーバーコード
• requirements.txt - 依存関係のリスト
• README.md - プロジェクトの説明ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。