MCP Server

🚀 MCP 服務器

MCP 服務器可賦予您的 AI 助手更高效協助您的能力。它能讓 AI 助手安全地訪問網站並搜索互聯網，同時在運行過程中提供清晰反饋，遇到問題時還會顯示有用的錯誤消息。

🚀 快速開始

MCP 服務器提供了強大的網絡訪問與搜索能力，讓您的 AI 助手如虎添翼。您可以根據自身需求，選擇合適的工具和運行方式。

✨ 主要特性

此服務器提供了兩個主要工具：

1. 網絡連接（SSE）：服務器在指定的網絡端口上監聽連接。
2. 直接連接（stdio）：服務器通過標準輸入/輸出進行通信。

使用場景

📦 安裝指南

🐳 使用 Docker（推薦）

1. 拉取 Docker 鏡像：

docker pull mcp-server:latest

2. 運行服務器容器：
   • 使用默認設置：

docker run --rm -it mcp-server:latest

- **自定義端口和環境變量**：

docker run --rm -e SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" -p 3001:3001 mcp-server:latest

💻 在本地運行

1. 創建並激活虛擬環境：

uv venv
source .venv/bin/activate  # Linux/macOS
# 或者
.venv\Scripts\activate     # Windows

2. 安裝依賴項：

uv sync

3. 設置環境變量：

export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080"
export USER_AGENT="CustomAgent/1.0"

4. 運行服務器：
   • 網絡模式（SSE）：

mcp-server --sse-host 0.0.0.0 --sse-port 3001

- **直接連接模式（stdio）**：

mcp-server

可用參數

• --sse-host：SSE 監聽地址（例如，0.0.0.0）。啟用 SSE 模式。
• --sse-port：SSE 監聽端口（例如，3001）。啟用 SSE 模式。
• --user-agent：自定義 User - Agent 字符串（覆蓋 USER_AGENT 環境變量）。

⚠️ 重要提示

如果未提供 --sse-host 或 --sse-port（且未設置 SSE_HOST/SSE_PORT 環境變量），服務器將默認使用 stdio 模式。SEARXNG_QUERY_URL 環境變量始終是必需的。

🔌 如何連接

您可以通過兩種方式連接到服務器：

📚 詳細文檔

以下資源可幫助您深入瞭解 MCP：

• MCP 規範
• MCP Python SDK
• MCP 示例服務器

📄 許可證

此項目 licensed under the GPLv3。有關詳細信息，請參閱 LICENSE 文件。