Lenses MCP

🚀 🌊🔍 Lenses MCP Server 🔎🌊

Lenses MCP Server 是 Lenses 的 MCP（模型上下文協議）服務器。Lenses 是一款自助式 DataOps 工具，供工程師跨多個集群使用不同版本的 Apache Kafka 構建實時應用程序。藉助它，你可以使用 SQL 探索、轉換和連接來自不同集群主題的數據，無需額外的數據庫。

你可以使用免費的 Lenses 社區版 進行嘗試（受用戶數量和企業功能限制，如 OAuth）。需要 Lenses v6 或更高版本。

🚀 快速開始

以下是啟動 Lenses MCP Server 的詳細步驟：

📦 安裝指南

1. 安裝 uv 和 Python

我們使用 uv 進行依賴管理和項目設置。如果你尚未安裝 uv，請遵循 官方安裝指南 進行安裝。

本項目使用 Python 3.12 構建，為確保 Python 已正確安裝，請運行以下命令檢查版本：

uv run python --version

2. 配置環境變量

複製示例環境文件：

cp .env.example .env

打開 .env 文件，並填寫所需的值，如你的 Lenses 實例詳細信息和 Lenses API 密鑰。

3. 添加 Lenses API 密鑰

通過創建 IAM 服務賬戶 來創建 Lenses API 密鑰。將 API 密鑰以變量名 LENSES_API_KEY 添加到 .env 文件中。

4. 安裝依賴項並運行服務器

使用 uv 創建虛擬環境，在其中安裝項目依賴項，然後使用 FastMCP CLI 以默認的 stdio 傳輸方式運行 MCP 服務器：

uv sync
uv run src/lenses_mcp/server.py

若要作為遠程服務器運行，請使用 http 傳輸方式：

uv run fastmcp run src/lenses_mcp/server.py --transport=http --port=8000

若要在 Claude Desktop、Gemini CLI、Cursor 等中運行，請使用以下 JSON 配置：

{
  "mcpServers": {
    "Lenses.io": {
      "command": "uv",
      "args": [
        "run",
        "--project", "<ABSOLUTE_PATH_TO_THIS_REPO>",
        "--with", "fastmcp",
        "fastmcp",
        "run",
        "<ABSOLUTE_PATH_TO_THIS_REPO>/src/lenses_mcp/server.py"
      ],
      "env": {
        "LENSES_API_KEY": "<YOUR_LENSES_API_KEY>"
      },
      "transport": "stdio"
    }
  }
}

注意：某些客戶端可能需要命令中 uv 的絕對路徑。

5. 可選：Context7 MCP 服務器

Lenses 文檔可在 Context7 上獲取。雖然可選，但強烈建議使用 Context7 MCP 服務器，並在提示中添加 use context7 以確保大語言模型（LLM）可訪問的文檔是最新的。

6. 使用 Docker 運行

Lenses MCP 服務器可作為 Docker 鏡像 lensesio/mcp 使用。你可以根據用例以不同的傳輸模式運行它。

快速啟動

以 stdio 傳輸方式（默認）運行服務器：

docker run \
   -e LENSES_API_KEY=<YOUR_API_KEY> \
   -e LENSES_URL=http://localhost:9991 \
   lensesio/mcp

以 HTTP 傳輸方式運行服務器（監聽 http://0.0.0.0:8000/mcp）：

docker run -p 8000:8000 \
   -e LENSES_API_KEY=<YOUR_API_KEY> \
   -e LENSES_URL=http://localhost:9991 \
   -e TRANSPORT=http \
   lensesio/mcp

以 SSE 傳輸方式運行服務器（監聽 http://0.0.0.0:8000/sse）：

docker run -p 8000:8000 \
   -e LENSES_API_KEY=<YOUR_API_KEY> \
   -e LENSES_URL=http://localhost:9991 \
   -e TRANSPORT=sse \
   lensesio/mcp

環境變量

舊版環境變量（用於向後兼容）：

• LENSES_API_HTTP_URL、LENSES_API_HTTP_PORT
• LENSES_API_WEBSOCKET_URL、LENSES_API_WEBSOCKET_PORT

這些變量會自動從 LENSES_URL 派生，但可以顯式設置以覆蓋默認值。

傳輸端點

• stdio：標準輸入/輸出（無網絡端點）
• http：/mcp 處的 HTTP 端點
• sse：/sse 處的服務器發送事件（Server-Sent Events）端點

構建 Docker 鏡像

若要在本地構建 Docker 鏡像，請運行以下命令：

docker build -t lensesio/mcp .