jinawebsearchmcp

探索

Jinawebsearchmcp

一個基於Jina AI API的MCP服務器，提供網頁內容抓取和語義搜索功能，支持Docker部署和Claude桌面集成。

搜索工具研究與數據 #網頁搜索 #內容抓取 #MCP協議 #AI工具 .Python

評分 : 2.5分

下載量 : 7.7K

更新時間 : 2025-08-15

打開站點

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "websearch": {
      "url": "http://localhost:5003/mcp"
    }
  }
}

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 Jina Web Search MCP

Jina Web Search MCP 是一個基於 Model Context Protocol (MCP) 的服務器，藉助 Jina AI API 提供獲取 URL 內容和執行網絡搜索的工具。它使用官方 MCP Python SDK 構建，為用戶提供便捷、高效的網絡搜索和內容獲取服務。

✨ 主要特性

MCP 協議兼容：完全符合 2025 - 06 - 18 版本的 Model Context Protocol。
FastMCP 實現：基於官方 Python MCP SDK 構建。
Docker 支持：可通過 Docker 和 Docker Compose 輕鬆部署。
可流式 HTTP 傳輸：運行在 5003 端口，採用現代傳輸方式。
兩大核心工具：
- fetch_url_content：使用 Jina AI 爬蟲從任意 URL 獲取內容。
- web_search：具備語義理解能力，可執行網絡搜索。
Claude Desktop 集成：通過 mcp install 即可輕鬆安裝。
開發工具：內置 mcp dev 用於測試。
錯誤處理：針對失敗請求提供優雅的錯誤響應。
環境配置：可通過環境變量配置 API 密鑰。
跨平臺支持：支持 Windows、Linux 和 macOS。
全面日誌記錄：提供詳細日誌，方便調試和監控。

📦 安裝指南

前提條件

Python 3.8+（MCP 所需）
Docker 與 Docker Compose（推薦用於部署），或者
uv（推薦）或 pip 用於包管理
Jina AI API 密鑰（在此獲取）

API 密鑰設置

⚠️ 重要提示

使用此服務器需要 Jina AI API 密鑰。

從 Jina AI 獲取 API 密鑰。
創建 .env 文件：

cp .env.example .env
# 編輯 .env 文件並添加：JINA_API_KEY=your_actual_api_key_here

安裝選項

選項 1：Claude Desktop 集成（最簡單）

直接安裝到 Claude Desktop 以便立即使用：

# 克隆倉庫
git clone https://github.com/hypersniper05/JinaWebSearchMCP.git
cd JinaWebSearchMCP

# 設置 API 密鑰
export JINA_API_KEY=your_actual_api_key_here  # Linux/Mac
# 或者
set JINA_API_KEY=your_actual_api_key_here     # Windows

# 安裝依賴並添加到 Claude Desktop
pip install -r requirements.txt
mcp install server.py --name "Jina Web Search"

選項 2：開發與測試

使用 MCP 檢查器測試和調試服務器：

# 安裝依賴（使用 uv - 推薦）
uv add mcp[cli] requests

# 使用 MCP 開發工具進行測試
uv run mcp dev server.py

# 或者使用 pip
pip install -r requirements.txt
mcp dev server.py

選項 3：Docker（生產環境）

# 克隆倉庫
git clone https://github.com/hypersniper05/JinaWebSearchMCP.git
cd JinaWebSearchMCP

# 在 .env 文件中設置 API 密鑰
cp .env.example .env
# 編輯 .env 文件並設置 JINA_API_KEY

# 使用 Docker Compose 構建並運行
docker-compose up -d

# 查看日誌
docker-compose logs -f

# 停止服務器
docker-compose down

簡易啟動腳本：

Windows：run.bat 或 run.ps1
Linux/Mac：./run.sh（使用 chmod +x run.sh 使其可執行）

選項 4：直接執行

# 安裝依賴
pip install -r requirements.txt

# 設置環境變量
export JINA_API_KEY=your_api_key_here  # Linux/Mac
# 或者
set JINA_API_KEY=your_api_key_here     # Windows

# 直接運行服務器
python server.py

服務器將在 http://localhost:5003 可用。

💻 使用示例

基礎用法

`fetch_url_content`

使用 Jina AI 的爬蟲服務從給定 URL 獲取並返回內容。參數：

url（字符串）：要獲取內容的 URL

示例用法：

{
  "name": "fetch_url_content",
  "arguments": {
    "url": "https://example.com"
  }
}

`web_search`

使用 Jina AI API 執行語義網絡搜索。參數：

query（字符串）：要執行的搜索查詢

示例用法：

{
  "name": "web_search",
  "arguments": {
    "query": "latest technology news"
  }
}

📚 詳細文檔

MCP 集成

Claude Desktop

安裝後，服務器將出現在 Claude Desktop 中：

安裝：mcp install server.py --name "Jina Web Search"
可用工具 將出現在 Claude 的界面中
自然使用：讓 Claude 進行網絡搜索或獲取 URL 內容
日誌：在 ~/.config/claude-desktop/ 中查看日誌

其他 MCP 客戶端

此服務器可與任何 MCP 兼容的客戶端配合使用：

VS Code MCP 擴展：通過可流式 HTTP 連接
自定義客戶端：使用官方 MCP Python SDK
瀏覽器客戶端：連接到 http://localhost:5003/mcp

客戶端示例：

{
  "mcpServers": {
    "websearch": {
      "url": "http://localhost:5003/mcp"
    }
  }
}

Docker 詳情

Docker 設置包括：

多階段構建優化，以減小鏡像大小
健康檢查，用於容器監控
環境變量處理，用於安全的 API 密鑰管理
自動重啟策略，確保生產環境的可靠性
端口映射，便於訪問（5003:5003）

配置

環境變量

屬性	詳情
`JINA_API_KEY`	你的 Jina AI API 密鑰，必需，默認值為 `your_jina_api_key_here`

服務器配置

主機：0.0.0.0（為兼容 Docker，支持所有接口）
端口：5003
傳輸：可流式 HTTP（現代 MCP 傳輸方式）
協議：Model Context Protocol 2025 - 06 - 18
框架：FastMCP（官方 Python SDK）

🔧 技術細節

本項目使用官方 Model Context Protocol Python SDK 構建，遵循 Model Context Protocol 規範。藉助 Jina AI 的強大能力，實現了網絡爬蟲和搜索功能。項目採用多階段 Docker 構建優化鏡像大小，支持健康檢查、環境變量處理、自動重啟策略等，確保在生產環境中的可靠性和安全性。