Code Context MCP

🚀 コードコンテキストMCPサーバ

このサーバは、ローカルのGitリポジトリからコードのコンテキストを提供するモデルコンテキストプロトコル（MCP）サーバです。以下の操作が可能です。

1. ローカルにGitリポジトリをクローンする
2. ブランチとファイルを処理する
3. コードスニペットの埋め込みを生成する
4. コードに対して意味検索を実行する

✨ 主な機能

• GitHub APIではなく、ローカルのGitリポジトリを使用する
• データをSQLiteデータベースに保存する
• コードを意味的なブロックに分割する
• Ollamaを使用してコードスニペットの埋め込みを生成する
• コードに対する意味検索を提供する

📦 インストール

前提条件

• Node.js (v16+)
• Git
• 埋め込みモデル付きのOllama

インストール手順

# リポジトリをクローンする
git clone <repository-url>
cd code-context-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

設定

以下の環境変数を設定してください。

• DATA_DIR：SQLiteデータベースのディレクトリ（デフォルト：~/.codeContextMcp/data）
• REPO_CACHE_DIR：クローンしたリポジトリのディレクトリ（デフォルト：~/.codeContextMcp/repos）

Ollamaの使用

より高速で強力な埋め込みを行うために、Ollamaを使用することができます。

# https://ollama.ai/ からOllamaをインストールする
# 埋め込みモデルを取得する（unclemusclez/jina-embeddings-v2-base-codeを推奨）
ollama pull unclemusclez/jina-embeddings-v2-base-code

💻 使用例

Claude Desktopとの連携

Claude Desktopの設定ファイル（claude_desktop_config.json）に以下の設定を追加してください。

{
  "mcpServers": {
    "code-context-mcp": {
      "command": "/path/to/your/node",
      "args": ["/path/to/code-context-mcp/dist/index.js"]
    }
  }
}

提供されるツール

サーバは以下のツールを提供します。

queryRepo

リポジトリをクローンし、コードを処理し、意味検索を実行します。

{
  "repoUrl": "https://github.com/username/repo.git",
  "branch": "main", // オプション - デフォルトはリポジトリのデフォルトブランチ
  "query": "あなたの検索クエリ",
  "keywords": ["keyword1", "keyword2"], // オプション - キーワードで結果をフィルタリング
  "filePatterns": ["**/*.ts", "src/*.js"], // オプション - globパターンでファイルをフィルタリング
  "excludePatterns": ["**/node_modules/**"], // オプション - globパターンでファイルを除外
  "limit": 10 // オプション - 結果の数（デフォルト：10）
}

デバッグ

Mac MシリーズのARMアーキテクチャに関する問題を解決するには、以下のコマンドを試してください。

# 以下のコマンドを試す
curl http://localhost:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://127.0.0.1:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://[::1]:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'

📄 ライセンス

MIT