mcp-code-search-server

mcp-code-search-server

LLM がファイル内の関連コードの位置を検索できるようにし、関数定義全体を返す MCP サーバーです。 An MCP Server, which helps the LLM find the location of relevant code within files and supports returning the complete function definitions.

プロジェクト概要

mcp-code-search-server は、Model Context Protocol（MCP）に基づいて実装されたサーバーで、大規模言語モデル（LLM）にコード検索機能を提供します。コードベース内の識別子（変数、関数、クラスなど）を正確に特定し、参照箇所だけでなく、その完全な定義を返します。コード定義全体とそのコンテキストを取得することで、LLM がコードの内部ロジック、データフロー、依存関係をより深く理解できるようになります。

主な機能

• コード検索：ripgrep を使用して、コードベース内の識別子を効率的に検索します
• 多言語対応：JavaScript/TypeScript、Java、Python のコード解析に対応しています
• 定義全体の抽出：変数、関数、クラスなどの定義全体を自動で識別して抽出します
• 多様なエンコーディングへの対応：ファイルの異なるエンコーディング（UTF-8、GBK、Big5 など）を自動で検出して処理します
• スマートフィルタリング：一般的なコード以外のディレクトリやファイル形式を除外するデフォルト設定を提供します

インストール方法

# 使用npm安装
npm install mcp-code-search-server

# 或使用pnpm安装
pnpm install mcp-code-search-server

使用方法

コマンドラインツールとして使用する

npx mcp-code-search-server

デバッグモードで使用する

# 构建项目
npm run build

# 运行调试器
npm run debug

# 或者一步执行
npm run build-debug

LLM ツールに統合する

このサーバーは MCP プロトコルに基づいており、サーバーとして呼び出すことができます。大規模言語モデルは、stdio インターフェースを介してサーバーと通信できます。

{
  "mcp": {
    "servers": {
      "code-search": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-code-search-server"
        ]
      }
    }
  }
}

API パラメーターの説明

search-files ツール

コード識別子を検索し、その定義全体を返します。

パラメーター	型	必須	説明
query	string	はい	検索するコード識別子（変数名、関数名、クラス名など）
cwd	string	はい	検索対象のディレクトリパス
filePattern	string	いいえ	ファイルの絞り込みに使用する glob パターン（例：'*.ts'）
excludePatterns	string[]	いいえ	検索対象から除外するファイルパターンの配列
excludeDirs	string[]	いいえ	検索対象から除外するディレクトリの配列

対応言語

• JavaScript/TypeScript
• Java
• Python