Sourcerer MCP

🚀 ソーサラーMCP 🧙

セマンティックコード検索とナビゲーション用のMCPサーバーです。AIエージェントが高価なトークンを浪費することなく効率的に作業できるよう支援します。エージェントは、ファイル全体を読む代わりに、概念的に検索して、必要な特定の関数、クラス、コードチャンクに直接ジャンプすることができます。

🎥 デモ

📋 必要条件

• OpenAI APIキー：埋め込みを生成するために必要です（ローカル埋め込みのサポートが予定されています）
• Git：Gitリポジトリである必要があります（.gitignoreファイルを尊重します）
• .gitignoreに.sourcerer/を追加する：このディレクトリには、埋め込みベクターデータベースが保存されます

📦 インストール

Go

go install github.com/st3v3nmw/sourcerer-mcp/cmd/sourcerer@latest

Homebrew

brew tap st3v3nmw/tap
brew install st3v3nmw/tap/sourcerer

⚙️ 設定

Claude Code

claude mcp add sourcerer -e OPENAI_API_KEY=your-openai-api-key -e SOURCERER_WORKSPACE_ROOT=$(pwd) -- sourcerer

mcp.json

{
  "mcpServers": {
    "sourcerer": {
      "command": "sourcerer",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "SOURCERER_WORKSPACE_ROOT": "/path/to/your/project"
      }
    }
  }
}

💡 仕組み

ソーサラーは、コードベースのセマンティック検索インデックスを構築します。

1. コードの解析とチャンク化

• Tree-sitterを使用してソースファイルを抽象構文木（AST）に解析します
• 安定したIDを持つ意味のあるチャンク（関数、クラス、メソッド、型）を抽出します
• 各チャンクには、ソースコード、位置情報、およびコンテキストの要約が含まれます
• チャンクIDは、file.ext::TypeName::methodNameのパターンに従います

2. ファイルシステムの統合

• fsnotifyを使用してファイルの変更を監視します
• git check-ignoreを介して.gitignoreファイルを尊重します
• 変更されたファイルを自動的に再インデックスします
• 変更時刻を追跡するためのメタデータを保存します

3. ベクターデータベース

• chromem-goを使用して、.sourcerer/db/に永続的なベクターストレージを提供します
• OpenAIのAPIを介して埋め込みを生成し、セマンティック類似性を実現します
• 単なるテキストマッチングではなく、概念的な検索を可能にします
• チャンク、その埋め込み、およびメタデータを維持します

4. MCPツール

• semantic_search：概念/機能でコードを検索します
• get_source_code：IDで特定のチャンクを取得します
• index_workspace：再インデックスを手動でトリガーします
• get_index_status：インデックス作成の進捗状況を確認します

このアプローチにより、AIエージェントはファイル全体を読むことなく関連するコードを見つけることができ、トークンの使用量と認知負荷を大幅に削減します。

🌐 サポートされている言語

言語のサポートには、各言語の関数、クラス、インターフェース、およびその他のコード構造を識別するためのTree-sitterクエリを記述する必要があります。

サポートされている言語：Go

予定されている言語：Python、TypeScript、JavaScript

🤝 コントリビューション

すべてのコントリビューションを歓迎します！