Dolphin MCP

🚀 dolphin-mcp

dolphin-mcp 是用於 Dolphin 語義代碼搜索的 MCP 服務器，它遵循 MCP 規範，能夠幫助用戶在代碼搜索和知識查詢方面提供高效的服務。

🚀 快速開始

無需安裝，可直接使用 bunx：

bunx dolphin-mcp

📦 安裝指南

如果你希望全局安裝：

bun install -g dolphin-mcp

安裝完成後，使用 dolphin-mcp 替代 bunx dolphin-mcp。

📚 詳細文檔

配置

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

可用工具

search_knowledge

對索引倉庫中的代碼和文檔進行語義查詢，並返回帶有引用的排名代碼片段。

{
  "query": "string (必需)",
  "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：排除匹配 glob 模式的文件（例如 ["*.test.ts", "*.config.json"]）

示例：

{
  "query": "身份驗證邏輯",
  "repos": ["myapp"],
  "path_prefix": ["src/"],
  "exclude_paths": ["tests/"],
  "exclude_patterns": ["*.spec.ts", "*.mock.ts"]
}

fetch_chunk

通過 chunk_id 獲取一個代碼塊，並返回帶有引用的代碼塊。

{
  "chunk_id": "string (必需)"
}

fetch_lines

從磁盤獲取文件的一個切片 [start, end]（包含），並返回帶有引用的代碼塊。

{
  "repo": "string (必需)",
  "path": "string (必需)",
  "start": "number (必需，從 1 開始編號)",
  "end": "number (必需，包含)"
}

get_vector_store_info

報告命名空間、維度、限制和近似計數。

{}

open_in_editor

計算一個 vscode://file URI，用於打開倉庫路徑和可選位置。

{
  "repo": "string (必需)",
  "path": "string (必需)",
  "line": "number (從 1 開始編號)",
  "column": "number (從 1 開始編號)"
}

🔧 技術細節

要求

• Bun >= 1.0.0 - 安裝
• Dolphin API 在配置的端點上運行

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🔗 鏈接

• NPM 包
• GitHub 倉庫
• MCP 規範