Dolphin MCP

🚀 dolphin-mcp

Dolphinの意味的コード検索用のMCPサーバーです。MCP仕様に準拠しています。

🚀 クイックスタート

インストールは不要で、bunxを使用できます。

bunx dolphin-mcp

✨ 主な機能

このサーバーはDolphinの意味的コード検索に使用され、MCP仕様に準拠しています。複数のツールを提供し、コードやドキュメントの検索、チャンクの取得、ファイルスライスの取得などの操作が可能です。

📦 インストール

オプション：グローバルインストール

グローバルにインストールする場合は、以下のコマンドを実行します。

bun install -g dolphin-mcp

その後、bunx dolphin-mcpの代わりにdolphin-mcpを使用できます。

💻 使用例

各種ツールの使用方法

search_knowledge

インデックスされたリポジトリ全体のコードとドキュメントを意味的にクエリし、引用付きのランク付けされたスニペットを返します。

{
  "query": "string (required)",
  "repos": ["string"],
  "path_prefix": ["string"],
  "exclude_paths": ["string"],
  "exclude_patterns": ["string"],
  "top_k": "number (1-100)",
  "max_snippets": "number",
  "embed_model": "small | large",
  "score_cutoff": "number"
}

フィルタリングオプション:

• repos: 特定のリポジトリのみを含める
• path_prefix: これらの接頭辞に一致するパスのみを含める（例: ["src/", "lib/"]）
• exclude_paths: これらの接頭辞に一致するパスを除外する（例: ["tests/", "node_modules/", "dist/"]）
• exclude_patterns: グロブパターンに一致するファイルを除外する（例: ["*.test.ts", "*.config.json"]）

例:

{
  "query": "authentication logic",
  "repos": ["myapp"],
  "path_prefix": ["src/"],
  "exclude_paths": ["tests/"],
  "exclude_patterns": ["*.spec.ts", "*.mock.ts"]
}

fetch_chunk

chunk_idでチャンクを取得し、引用付きのコードを返します。

{
  "chunk_id": "string (required)"
}

fetch_lines

ディスクからファイルスライス[start, end]（含む）を取得し、引用付きのコードを返します。

{
  "repo": "string (required)",
  "path": "string (required)",
  "start": "number (required, 1-indexed)",
  "end": "number (required, inclusive)"
}

get_vector_store_info

名前空間、次元、制限、および概算数を報告します。

{}

open_in_editor

リポジトリパスとオプションの位置のvscode://file URIを計算します。

{
  "repo": "string (required)",
  "path": "string (required)",
  "line": "number (1-indexed)",
  "column": "number (1-indexed)"
}

📚 ドキュメント

設定方法

Continue.dev

config.yamlに以下を追加します。

mcpServers:
  - name: Dolphin-KB
    command: bunx
    args:
      - dolphin-mcp
    env:
      DOLPHIN_API_URL: "http://127.0.0.1:7777"
      # オプション: 並列スニペット取得のパフォーマンス最適化
      MAX_CONCURRENT_SNIPPET_FETCH: "8"
      SNIPPET_FETCH_TIMEOUT_MS: "2000"
      SNIPPET_FETCH_RETRY_ATTEMPTS: "1"

Claude Desktop

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

{
  "mcpServers": {
    "dolphin-kb": {
      "command": "bunx",
      "args": ["dolphin-mcp"],
      "env": {
        "DOLPHIN_API_URL": "http://127.0.0.1:7777",
        "MAX_CONCURRENT_SNIPPET_FETCH": "8",
        "SNIPPET_FETCH_TIMEOUT_MS": "2000",
        "SNIPPET_FETCH_RETRY_ATTEMPTS": "1"
      }
    }
  }
}

環境変数

並列スニペット取得の設定

これらの変数は、search_knowledgeでの並列スニペット取得のパフォーマンス最適化を制御します。

設定プリセット

保守的（リソースが限られている場合に推奨）:

MAX_CONCURRENT_SNIPPET_FETCH=4
SNIPPET_FETCH_TIMEOUT_MS=1500
SNIPPET_FETCH_RETRY_ATTEMPTS=1

推奨（バランスの取れたパフォーマンス）:

MAX_CONCURRENT_SNIPPET_FETCH=8
SNIPPET_FETCH_TIMEOUT_MS=2000
SNIPPET_FETCH_RETRY_ATTEMPTS=1

パフォーマンス（最大スループット）:

MAX_CONCURRENT_SNIPPET_FETCH=10
SNIPPET_FETCH_TIMEOUT_MS=3000
SNIPPET_FETCH_RETRY_ATTEMPTS=2

🔧 技術詳細

このサーバーはDolphinの意味的コード検索に使用され、MCP仕様に準拠しています。複数のツールを提供し、コードやドキュメントの検索、チャンクの取得、ファイルスライスの取得などの操作が可能です。環境変数を使用して、並列スニペット取得のパフォーマンスを最適化できます。

📄 ライセンス

MITライセンスです。詳細はLICENSEファイルを参照してください。

🔗 リンク

• NPMパッケージ
• GitHubリポジトリ
• MCP仕様