Python MCP Server for Code Graph Extraction

Python MCP Server for Code Graph Extraction

site icon
2025.03.16 3
Python代码分析Python开发工具开发效率
Python MCP Server 是一个专注于Python代码结构提取和分析的工具,特别关注文件之间的导入/导出关系。它是一个轻量级的实现,不需要代理系统,可以轻松集成到任何Python应用程序中。
View on GitHub

Overview

基本能力

产品定位

Python MCP Server 是一个用于Python代码结构分析和提取的工具,特别关注文件之间的导入/导出关系。

核心功能

  • 代码关系发现:分析Python文件之间的导入关系
  • 智能代码提取:提取最相关的代码部分以保持在令牌限制内
  • 目录上下文:包括来自同一目录的文件以提供更好的上下文
  • 文档包含:始终包含README.md文件(或其变体)以提供项目文档
  • LLM友好格式:用适当的元数据格式化代码以供语言模型使用
  • MCP协议支持:完全兼容Model Context Protocol JSON-RPC标准

适用场景

  • Python代码库的结构分析
  • 代码依赖关系可视化
  • 为语言模型提供上下文相关的代码片段
  • 代码库文档生成

工具列表

  • get_python_code:返回目标Python文件及其相关文件的代码,基于导入/导出关系

常见问题解答

  • 如何处理不存在的文件路径?会返回错误响应,指示文件不存在
  • 如何调整令牌限制?通过环境变量TOKEN_LIMIT设置

使用教程

使用依赖

# Clone the repository
git clone https://github.com/yourusername/python-mcp-new.git
cd python-mcp-new

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

安装教程

创建.env文件基于提供的.env.example:

# Token limit for extraction
TOKEN_LIMIT=8000

调试方式

运行测试以验证功能:

python -m unittest discover tests

启动服务器:

# Start the server with default settings
python run_server.py

使用MCP开发模式:

# Install the MCP CLI
pip install "mcp[cli]"

# Start the server in development mode with the Inspector UI
mcp dev server.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。