MCP Server

MCP 服务器

赋予您的 AI 助手更强大的功能，使其能够更有效地为您提供帮助。该服务器可让它们安全地访问网站并进行搜索，并提供清晰的实时反馈，并在出现问题时提供有用的错误消息。

• 🛠️ 该服务器提供哪些工具？
• 🏎️我该如何运行它？
  • 🐋 使用 Docker（推荐）
  • 💻本地运行
• 🔌 如何连接
• 📚 了解有关 MCP 的更多信息
• 📄 许可证

🛠️ 该服务器提供哪些工具？

该服务器提供了两个强大的工具，帮助AI助手解决现实世界的问题：

🏎️我该如何运行它？

🐋 使用 Docker（推荐）

该服务器在 Docker 容器中运行，以确保安全且简单。以下是入门方法：

1. 如果尚未安装 Docker
2. 创建一个名为docker-compose.yml的文件，内容如下：
   services: mcp-server: environment: # Required: URL for your SearXNG instance's Search API - SEARXNG_QUERY_URL=http://searxng:8080 # Optional: Configure network mode (SSE) for LibreChat etc. - SSE_HOST=0.0.0.0 - SSE_PORT=8080 # Optional: Set a custom User-Agent for web requests - USER_AGENT=MCP-Server/1.0 (github.com/tcpipuk/mcp-server) image: ghcr.io/tcpipuk/mcp-server/server:latest ports: # Only needed if using SSE_HOST/SSE_PORT - "8080:8080" # Expose port 8080 on host restart: unless-stopped stop_grace_period: 1s # Example SearXNG service (optional, adapt as needed) # searxng: # environment: # - SEARXNG_BASE_URL=http://searxng:8080 # Ensure SearXNG knows its own URL # image: searxng/searxng:latest # restart: unless-stopped # volumes: # - ./searxng:/etc/searxng:rw

   重要提示：您必须提供SEARXNG_QUERY_URL环境变量，指向 SearXNG 实例的搜索 API 端点（通常以/或/search结尾）。

   设置SSE_HOST和SSE_PORT可启用网络模式（服务器发送事件），推荐用于像 LibreChat 这样的多容器设置。如果省略，服务器将使用标准 I/O。

3. 运行docker compose up -d来启动服务器容器（以及可选的 SearXNG）。

大多数人会将其与以下任一方式一起使用：

• Claude Desktop - 通过 stdio 直接连接（省略docker-compose.yml中的SSE_HOST / SSE_PORT ）。
• LibreChat——通过 SSE 连接网络。

对于 LibreChat，将其添加到您的librechat.yaml （假设SSE_PORT=8080 ）：

💻本地运行

1. 安装uv （需要 Python 3.13+）：
   curl -LsSf https://astral.sh/uv/install.sh | sh

   **注意：**如果您已经安装了uv ，请使用uv self update进行更新。

2. 创建并激活虚拟环境：
   uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
3. 从锁文件安装依赖项：
   uv sync
4. 设置所需的环境变量：
   # Required: URL for your SearXNG instance's Search API export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" # Optional: Custom User-Agent export USER_AGENT="CustomAgent/1.0"
5. 运行服务器：
   # For network (SSE) mode (e.g., for LibreChat) mcp-server --sse-host 0.0.0.0 --sse-port 3001 # For direct stdio mode (e.g., for Claude Desktop) mcp-server

可用参数：

• --sse-host ：SSE 监听地址（例如0.0.0.0 ）。启用 SSE 模式。
• --sse-port ：SSE 监听端口（例如3001 ）。启用 SSE 模式。
• --user-agent ：自定义用户代理字符串（覆盖USER_AGENT环境变量）。

注意：如果未提供--sse-host或--sse-port SEARXNG_QUERY_URL且未设置SSE_HOST / SSE_PORT环境变量），则服务器默认为stdio模式。SEARXNG_QUERY_URL 环境变量始终为必需。

🔌 如何连接

您可以通过两种方式连接到服务器：

📚 了解有关 MCP 的更多信息

以下是一些可帮助您入门的资源：

• MCP 规范
• MCP Python SDK
• MCP 示例服务器

📄 许可证

本项目遵循 GPLv3 许可。请参阅许可证文件以了解更多详情。