Python Code Explorer

🚀 Python 代碼分析工具

本項目是一款強大的Python代碼分析工具，提供了豐富的代碼分析功能，並且全面支持Model Context Protocol (MCP) 標準，能有效提升代碼分析效率與質量，助力開發者更好地進行代碼管理與開發。

🚀 快速開始

安裝依賴項

安裝項目所需的Python包：

pip install mcp[yaml]

克隆倉庫

克隆此倉庫到本地：

git clone https://github.com/yourusername/python-code-analyzer.git
cd python-code-analyzer

啟動代理或服務器

根據需求啟動原生MCP實現的代理或MCP SDK實現的服務器。

✨ 主要特性

主要功能

1. 代碼提取
2. 依賴分析
3. 資源提供
4. 自定義工具

MCP 集成

本項目有兩種實現方式來支持MCP協議：

1. 原生 MCP 實現：位於agent.py中的直接JSON - RPC接口，與MCP兼容。
2. MCP SDK 實現：位於server.py中，使用官方的Python MCP SDK，提供更強大和功能豐富的體驗。

優勢

• 標準化接口：使您的工具可供任何MCP兼容客戶端使用
• 增強安全：內置權限模型和資源控制
• 更好的LLM集成：與Claude Desktop和其他LLM平臺無縫集成
• 改進的開發人員體驗：全面的工具支持，例如MCP Inspector

MCP 協議版本

此實現支持MCP協議版本0.7.0。有關更多詳細信息，請參閱官方文檔。

📦 安裝指南

安裝項目所需的Python包：

pip install mcp[yaml]

💻 使用示例

原生 MCP 實現（agent.py）

啟動代理

# 以默認設置啟動
python agent.py

# 指定自定義名稱
python agent.py --name "My Code Explorer"

# 使用特定的.env文件
python agent.py --env-file .env.production

開發模式

使用MCP CLI在開發模式下啟動代理：

# 安裝MCP CLI
pip install "mcp[cli]"

# 在開發模式下啟動代理並帶有Inspector UI
mcp dev agent.py

MCP SDK 實現（server.py）

啟動服務器

# 以默認設置啟動服務器
python server.py

# 指定自定義名稱
python server.py --name "Custom Code Explorer"

# 使用特定的配置文件
python server.py --config config.yaml

在Claude Desktop中集成

將此代理安裝到Claude Desktop：

# 安裝代理到Claude Desktop
mcp install agent.py

# 指定自定義名稱和配置文件
mcp install agent.py --name "Python Code Analyzer" -f config.yaml

自定義部署

對於自定義部署，可以直接使用MCP服務器：

from server import Server

# 配置服務器
server.name = "Custom Python Analyzer"

# 啟動服務器
server.run()

示例代碼運行

使用 MCP 客戶端

可以在examples/mcp_client_example.py中找到示例：

from mcp.client import Client, Transport

# 連接到服務器
client = Client(Transport.subprocess(["python", "server.py"]))
client.initialize()

# 列出所有可用工具
for tool in client.tools:
    print(f"Tool: {tool.name}")

# 使用 get_code 工具
result = client.tools.get_code(target_file="path/to/your/file.py")
print(f"找到 {len(result['referenced_files'])} 個引用文件")

# 關閉連接
client.shutdown()

運行示例：

python examples/mcp_client_example.py [optional_target_file.py]

原生 MCP 實現示例

使用agent.py中的功能：

# 提取代碼並分析依賴關係
python agent.py extract --file /path/to/your/script.py

# 分析資源
python agent.py analyze - resources --source /path/to/resource

📚 詳細文檔

擴展功能

添加更多工具

可以在server.py中添加其他工具，通過裝飾器@mcp.tool()：

@mcp.tool()
def analyze_imports(target_file: str) -> Dict[str, Any]:
    """分析Python文件中的所有導入模塊"""
    # 實現代碼
    return {
        "file": target_file,
        "imports": [],  # 導入模塊列表
        "analysis": ""  # 導入分析結果
    }

添加資源端點

可以添加資源端點來提供數據：

@mcp.resource("python_stats://{directory}")
def get_stats(directory: str) -> Dict[str, Any]:
    """獲取指定目錄中Python文件的統計信息"""
    from pathlib import Path
    stats = {
        "directory": directory,
        "file_count": 0,
        "total_lines": 0,
        "average_lines": 0
    }
    
    files = list(Path(directory).glob("**/*.py"))
    stats["file_count"] = len(files)
    
    if files:
        total_lines = 0
        for file in files:
            with open(file, "r") as f:
                total_lines += len(f.readlines())
        stats["total_lines"] = total_lines
        stats["average_lines"] = total_lines / len(files)
    
    return stats

配置

原生 MCP 實現配置

可以在config.yaml中找到默認配置：

log_level: INFO
bind: 0.0.0.0
port: 5000

MCP SDK 實現配置

可以在server_config.yaml中找到默認配置：

name: Python Code Analyzer Server
bind: 0.0.0.0
port: 8000
tools:
  enabled:
    analyze_imports: true
    get_stats: true

🔧 技術細節

項目結構

• agent.py - 原生 MCP 實現的代理
• server.py - MCP SDK 實現的服務器
• examples/ - 示例代碼
• config.yaml - 默認配置文件