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 许可证。