Nuanced MCP Server

Nuanced MCP 服务

一个 Model Context Protocol (MCP) 服务，通过 nuanced 库向大模型提供调用图分析能力。

概述

此 MCP 服务通过标准化的工具和资源访问函数调用图，帮助大模型理解代码结构。它可以让 AI 助手：

• 为 Python 仓库初始化调用图
• 探索函数调用关系
• 分析函数之间的依赖关系
• 提供更了解上下文的代码协助

API

工具

• 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

UV

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