Nuanced MCP Server

Nuanced MCP Server

Um servidor Model Context Protocol (MCP) que fornece capacidades de análise de grafo de chamadas para LLMs por meio da biblioteca nuanced.

Visão Geral

Este servidor MCP permite que LLMs entendam a estrutura do código acessando grafos de chamadas de funções por meio de ferramentas e recursos padronizados. Ele permite que assistentes de IA:

• Inicializem grafos de chamadas para repositórios Python
• Explorem relações de chamadas de funções
• Analisem dependências entre funções
• Forneçam assistência de código mais contextual

API

Ferramentas

• initialize_graph

  • Inicializa um grafo de código para o caminho do repositório fornecido
  • Entrada: repo_path (string)

• switch_repository

  • Alterna para um repositório inicializado diferente
  • Entrada: repo_path (string)

• list_repositories

  • Lista todos os repositórios inicializados
  • Nenhuma entrada necessária

• get_function_call_graph

  • Obtém o grafo de chamadas para uma função específica
  • Entradas:
    • file_path (string)
    • function_name (string)
    • repo_path (string, opcional) - usa o repositório ativo se não for especificado

• analyze_dependencies

  • Encontra todas as dependências de módulos ou arquivos no código
  • Entradas (pelo menos uma obrigatória):
    • file_path (string, opcional)
    • module_name (string, opcional)

• analyze_change_impact

  • Analisa o impacto de alterar uma função específica
  • Entradas:
    • file_path (string)
    • function_name (string)

Recursos

• graph://summary

  • Obtém um resumo do grafo de código atualmente carregado
  • Nenhum parâmetro necessário

• graph://repo/{repo_path}/summary

  • Obtém um resumo do grafo de código de um repositório específico
  • Parâmetros:
    • repo_path (string) - Caminho para o repositório

• graph://function/{file_path}/{function_name}

  • Obtém informações detalhadas sobre uma função específica
  • Parâmetros:
    • file_path (string) - Caminho para o arquivo que contém a função
    • function_name (string) - Nome da função a ser analisada

Prompts

• analyze_function

  • Cria um prompt para analisar uma função com seu grafo de chamadas
  • Parâmetros:
    • file_path (string) - Caminho para o arquivo que contém a função
    • function_name (string) - Nome da função a ser analisada

• impact_analysis

  • Cria um prompt para analisar o impacto de alterar uma função
  • Parâmetros:
    • file_path (string) - Caminho para o arquivo que contém a função
    • function_name (string) - Nome da função a ser analisada

• analyze_dependencies_prompt

  • Cria um prompt para analisar dependências de um arquivo ou módulo
  • Parâmetros (pelo menos um obrigatório):
    • file_path (string, opcional) - Caminho para o arquivo a ser analisado
    • module_name (string, opcional) - Nome do módulo a ser analisado

Uso com Claude Desktop

Adicione isso ao seu claude_desktop_config.json

UV

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