Nuanced

🚀 細緻的MCP服務器

一個藉助 nuanced庫，提供代碼結構分析功能的MCP（模型上下文協議）服務器。該服務器能讓LLM（大語言模型）通過標準化工具和資源訪問函數調用圖，進而理解代碼結構。

概述

此MCP服務器可使LLM通過標準化工具和資源訪問函數調用圖，從而理解代碼結構。它能讓AI助手實現以下功能：

• 為Python倉庫初始化代碼圖。
• 探索函數調用關係。
• 分析函數之間的依賴關係。
• 提供更具語境感知的代碼輔助。

📚 詳細文檔

工具

• initialize_graph
  • 功能：初始化給定倉庫路徑的代碼圖。
  • 輸入：repo_path（字符串）。
• switch_repository
  • 功能：切換到不同的已初始化倉庫。
  • 輸入：repo_path（字符串）。
• list_repositories
  • 功能：列出所有已初始化的倉庫。
  • 輸入：無。
• get_function_call_graph
  • 功能：獲取特定函數的調用圖。
  • 輸入：
    • file_path（字符串）。
    • function_name（字符串）。
    • repo_path（字符串，可選）——若未指定，則使用活動倉庫。
• analyze_dependencies
  • 功能：找出代碼庫中的所有模塊或文件依賴項。
  • 輸入（至少需要一個）：
    • file_path（字符串，可選）。
    • module_name（字符串，可選）。
• analyze_change_impact
  • 功能：分析更改特定函數的影響。
  • 輸入：
    • file_path（字符串）。
    • function_name（字符串）。

資源

• graph://summary
  • 功能：獲取當前加載的代碼圖摘要。
  • 參數：無。
• graph://repo/{repo_path}/summary
  • 功能：獲取特定倉庫代碼圖的摘要。
  • 參數：
    • repo_path（字符串）——倉庫路徑。
• graph://function/{file_path}/{function_name}
  • 功能：獲取特定函數的詳細信息。
  • 參數：
    • file_path（字符串）——包含函數的文件路徑。
    • function_name（字符串）——要分析的函數名稱。

提示語

• analyze_function
  • 功能：創建一個提示以分析帶有調用圖的函數。
  • 參數：
    • file_path（字符串）——包含函數的文件路徑。
    • function_name（字符串）——要分析的函數名稱。
• impact_analysis
  • 功能：創建一個提示以分析更改函數的影響。
  • 輸入參數：
    • file_path（字符串）——包含函數的文件路徑。
    • function_name（字符串）——要分析的函數名稱。
• analyze_dependencies_prompt
  • 功能：創建一個提示以分析文件或模塊的依賴關係。
  • 輸入參數（至少需要一個）：
    • file_path（字符串，可選）——要分析的文件路徑。
    • module_name（字符串，可選）——要分析的模塊名稱。

💻 使用示例

基礎用法

在使用Claude Desktop時，將以下內容添加到你的claude_desktop_config.json：

{
  "mcpServers": {
    "nuanced": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/nuanced-mcp",
        "run",
        "nuanced_mcp_server.py"
      ]
    }
  }
}