Kursk Ye Code2flow MCP Server

🚀 Code2Flow MCP 服务器

本项目将 code2flow 命令行工具封装为 MCP（Model Context Protocol）服务器，借助标准化的 MCP 协议，让 AI 应用程序能够便捷地生成并访问代码调用图。

🚀 快速开始

本项目可让你借助 MCP 协议，利用 AI 应用程序生成和访问代码调用图。下面为你详细介绍安装及使用步骤。

✨ 主要特性

• 调用图生成：深入分析源代码，精准生成调用图。
• 多语言支持：全面支持 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"
  ]
}

高级用法

以下是使用 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 工具：

• generate_call_graph：生成代码调用图
• check_code2flow_version：检查 code2flow 版本
• analyze_code_complexity：分析代码复杂度

可用资源

服务器提供以下 MCP 资源：

• help://code2flow：帮助文档
• languages://supported：支持的语言列表
• call-graph://图像ID：生成的调用图图像

配置选项

生成调用图时，可使用以下配置选项：

• source_paths：指定要分析的源文件路径
• language：指定代码语言（支持 Python、JavaScript、Ruby、PHP）

文件结构

项目包含以下文件：

• server.py：主服务器代码
• requirements.txt：依赖项列表
• README.md：项目说明文档

📄 许可证

该项目采用 MIT 许可证。