Nuanced MCP Server

Nuanced MCP サーバー

nuanced ライブラリを通じて、LLM に呼び出しグラフの分析機能を提供する Model Context Protocol (MCP) サーバーです。

概要

この MCP サーバーは、標準化されたツールとリソースを介して関数の呼び出しグラフにアクセスし、LLM がコード構造を理解できるようにします。AI アシスタントは、次のことができます。

• Python リポジトリの呼び出しグラフを初期化する
• 関数の呼び出し関係を調べる
• 関数間の依存関係を分析する
• より文脈を考慮したコード支援を提供する

API

ツール

• initialize_graph

  • 指定したリポジトリパスのコードグラフを初期化します
  • 入力：repo_path (string)

• switch_repository

  • 初期化済みの別のリポジトリに切り替えます
  • 入力：repo_path (string)

• list_repositories

  • 初期化済みのすべてのリポジトリを一覧表示します
  • 入力は不要です

• get_function_call_graph

  • 特定の関数の呼び出しグラフを取得します
  • 入力：
    • file_path (string)
    • function_name (string)
    • repo_path (string, optional) - 指定しない場合はアクティブなリポジトリを使用します

• analyze_dependencies

  • コードベース内のすべてのモジュールまたはファイルの依存関係を検索します
  • 入力（少なくとも1つが必要）：
    • file_path (string, optional)
    • module_name (string, optional)

• analyze_change_impact

  • 特定の関数を変更した場合の影響を分析します
  • 入力：
    • file_path (string)
    • function_name (string)

リソース

• graph://summary

  • 現在読み込まれているコードグラフの概要を取得します
  • パラメーターは不要です

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

  • 特定のリポジトリのコードグラフの概要を取得します
  • パラメーター：
    • repo_path (string) - リポジトリへのパス

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

  • 特定の関数に関する詳細情報を取得します
  • パラメーター：
    • file_path (string) - 関数を含むファイルへのパス
    • function_name (string) - 分析する関数の名前

プロンプト

• analyze_function

  • 呼び出しグラフとともに関数を分析するプロンプトを作成します
  • パラメーター：
    • file_path (string) - 関数を含むファイルへのパス
    • function_name (string) - 分析する関数の名前

• impact_analysis

  • 関数を変更した場合の影響を分析するプロンプトを作成します
  • パラメーター：
    • file_path (string) - 関数を含むファイルへのパス
    • function_name (string) - 分析する関数の名前

• analyze_dependencies_prompt

  • ファイルまたはモジュールの依存関係を分析するプロンプトを作成します
  • パラメーター（少なくとも1つが必要）：
    • file_path (string, optional) - 分析するファイルへのパス
    • module_name (string, optional) - 分析するモジュールの名前

Claude Desktop での使用

claude_desktop_config.json に以下を追加します

UV

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