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