Code Context Provider MCP

Code Context Provider MCP

AI アシスタント向けにコードのコンテキストと分析を提供する MCP サーバーです。WebAssembly の Tree-sitter パーサーを使用してディレクトリ構造とコードシンボルを抽出します。ネイティブ依存関係はありません。

---

機能

• ディレクトリツリー構造を生成します
• JavaScript/TypeScript および Python ファイルを分析します
• コードシンボル（関数、変数、クラス、インポート、エクスポート）を抽出します
• MCP プロトコルに対応しており、AI アシスタントとシームレスに統合できます

クイック使用方法（MCP のセットアップ）

Smithery 経由でインストール

Smithery 経由で Code Context Provider を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @AB498/code-context-provider-mcp --client claude

Windows

{
  "mcpServers": {
    "code-context-provider-mcp": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "npx",
        "-y",
        "code-context-provider-mcp@latest"
      ]
    }
  }
}

MacOS/Linux

{
  "mcpServers": {
    "code-context-provider-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "code-context-provider-mcp@latest"
      ]
    }
  }
}

または、npm を使ってグローバルにインストールします：

npm install -g code-context-provider-mcp

次のコマンドを実行して使用します：

code-context-provider-mcp # if you're not using @latest, you may want to clear the cache for latest version using `Remove-Item -Path "$env:LOCALAPPDATA\npm-cache\_npx" -Recurse -Force` for windows and `rm -rf ~/.npm/_npx` for linux/macos

利用可能なツール

get_code_context

ディレクトリを分析し、その構造とコードシンボル（任意）を返します。

パラメーター：

• absolutePath (string, required)：分析するディレクトリの絶対パス
• analyzeJs (boolean, optional)：JavaScript/TypeScript および Python ファイルを分析するかどうか（デフォルト：false）
• includeSymbols (boolean, optional)：レスポンスにコードシンボルを含めるかどうか（デフォルト：false）
• symbolType (enum, optional)：includeSymbols が true の場合に含めるシンボルの種類（選択肢：'functions'、'variables'、'classes'、'imports'、'exports'、'all'、デフォルト：'all'）
• filePatterns (array of strings, optional)：分析するファイルパターン（例：['.js', '.py', 'config.*']）
• maxDepth (number, optional)：分析するディレクトリの最大階層数（デフォルト：5 階層）

注：無名関数は結果から自動的に除外されます。

ツール呼び出し時の出力テキストの例

Directory structure for: C:\Users\Admin\Desktop\mcp\context-provider-mcp

Code Analysis Summary:
- Files analyzed: 3
- Total functions: 29
- Total variables: 162
- Total classes: 0

Note: Symbol analysis is supported for JavaScript/TypeScript (.js, .jsx, .ts, .tsx) and Python (.py) files only.

Code analysis limited to a maximum depth of 5 directory levels (default).

├── index.js (39 KB)
│   └── [Analyzed: 22 functions, 150 variables, 0 classes]
│       Functions:
│       - initializeTreeSitter [39:0]
│       - getLanguageFromExtension [107:0]
│       - getPosition [138:24]

ファイルパターンの例

filePatterns パラメーターを使って、分析するファイルを指定できます。複数の言語が混在する複雑なプロジェクトや、特定のファイルに注目したい場合に便利です。

例：

• ["*.js", "*.py"] - すべての JavaScript ファイルと Python ファイルを分析します
• ["config.*"] - 拡張子に関係なく、すべての設定ファイルを分析します
• ["package.json", "*.config.js"] - package.json と、JavaScript の設定ファイルをすべて分析します
• [".ts", ".tsx", ".py"] - TypeScript ファイルと Python ファイルを分析します（拡張子形式を使用）

ファイルパターンの照合では、次の形式に対応しています：

• ワイルドカード (*) を含むシンプルな glob パターン
• 直接指定するファイル拡張子（ドットの有無を問わない）
• ファイル名の完全一致

大規模プロジェクトへの対応

非常に大規模なプロジェクトでは、maxDepth パラメーターを使って、ツールがディレクトリをたどる深さを制限できます：

• maxDepth: 2 - ルートディレクトリと、その直下のサブディレクトリのみを分析します
• maxDepth: 3 - ルートディレクトリと、2 階層下までのサブディレクトリを分析します
• maxDepth: 0 - ルートディレクトリ内のファイルのみを分析します

特に次の場合に便利です：

• 大規模なモノレポを扱う場合
• 依存関係が多いプロジェクトを分析する場合
• サードパーティライブラリではなく、メインのソースコードだけに注目する場合

対応言語

コードシンボルの解析は、以下の言語に対応しています。

• JavaScript (.js)
• JSX (.jsx)
• TypeScript (.ts)
• TSX (.tsx)
• Python (.py)

filePatterns パラメーターを使用すると、ディレクトリー構造にほかのファイル形式を含めることができますが、シンボル解析は制限される場合があります。

開発

[開発] 開発環境のセットアップ

# Clone the repository
git clone https://github.com/your-username/code-context-provider-mcp.git
cd code-context-provider-mcp

# Install dependencies
npm install

# Set up WASM parsers
npm run setup

[開発] インストール後

インストール後、パッケージの prepare スクリプトが自動的に実行され、WASM パーサーがダウンロードされます。何らかの理由でダウンロードに失敗した場合は、ユーザーが手動でセットアップを実行できます。

npx code-context-provider-mcp-setup

ライセンス

MIT

詳細またはサポートについて

• メール（[email protected]）
• Discord（CodePlayground）