Code2flow MCP Server

🚀 Code2Flow MCP 服務器

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

🚀 快速開始

Code2Flow MCP 服務器可助力 AI 應用通過 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"
    })
    
    # 獲取資源 ID
    print(result)
    
    # 檢查code2flow版本
    version_result = await session.call_tool("check_code2flow_version")
    print(version_result)
    
    # 分析代碼複雜度
    complexity_result = await session.call_tool("analyze_code_complexity", {
        "source_paths": ["path/to/your/code"]
    })
    print(complexity_result)

if __name__ == "__main__":
    asyncio.run(main())

✨ 主要特性

• 調用圖生成：能夠分析源代碼並生成代碼調用圖。
• 多語言支持：支持 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 服務器：

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"
  ]
}

高級用法

服務器啟動時可以通過以下命令行參數進行配置：

• --port 或 -p：指定服務監聽的端口（默認：8000）
• --debug 或 -d：啟用調試模式

例如：

python server.py --port 8080 --debug

📚 詳細文檔

可用工具

服務器提供以下 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 - 生成的調用圖圖像

🔧 技術細節

文件結構

項目目錄結構如下：

code2flow-mcp-server/
├── server.py          # 主服務器文件
├── requirements.txt   # 依賴項列表
└── README.md          # 項目說明文檔

📄 許可證

本項目遵循 MIT 許可證。