🚀 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 文件。