Kursk Ye Code2flow MCP Server

🚀 Code2Flow MCP 服務器

本項目將 code2flow 命令行工具封裝為 MCP（Model Context Protocol）服務器，藉助標準化的 MCP 協議，讓 AI 應用程序能夠生成並訪問代碼調用圖。

🚀 快速開始

本項目可通過 Python 直接運行，也能借助 MCP 工具運行，以下為具體步驟：

直接使用 Python 運行

python server.py

使用 MCP 工具運行

使用 MCP Inspector 工具

mcp dev server.py

安裝到 Claude Desktop

mcp install server.py

添加到 Cursor MCP 配置

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

✨ 主要特性

• 分析源代碼並生成調用圖。
• 支持多種編程語言（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 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 許可證。