金大哥 - mcp-server MCP 详情

article

README

🚀 MCP 服务器

MCP 服务器可赋予您的 AI 助手更高效协助您的能力。它能让 AI 助手安全地访问网站并搜索互联网，同时在运行过程中提供清晰反馈，遇到问题时还会显示有用的错误消息。

🚀 快速开始

MCP 服务器提供了强大的网络访问与搜索能力，让您的 AI 助手如虎添翼。您可以根据自身需求，选择合适的工具和运行方式。

✨ 主要特性

此服务器提供了两个主要工具：

网络连接（SSE）：服务器在指定的网络端口上监听连接。
直接连接（stdio）：服务器通过标准输入/输出进行通信。

使用场景

| 方法 | 意味着什么 | 何时使用它 | | ---- | ---- | ---- | | 网络连接 (SSE) | 服务器在指定的网络端口上监听连接。 | 最适合 LibreChat 或其他网络化客户端。 | | 直接连接 (stdio) | 服务器通过标准输入/输出进行通信。 | 适用于本地测试或 Claude Desktop。 |

📦 安装指南

🐳 使用 Docker（推荐）

拉取 Docker 镜像：

docker pull mcp-server:latest

运行服务器容器：
- 使用默认设置：

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

💻 在本地运行

创建并激活虚拟环境：

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

安装依赖项：

uv sync

设置环境变量：

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

运行服务器：
- 网络模式（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 环境变量始终是必需的。

🔌 如何连接

您可以通过两种方式连接到服务器： | 方法 | 代表什么 | 在哪种情况下使用它 | | ---- | ---- | ---- | | 网络连接 (SSE) | 服务器在指定的网络端口上监听连接。 | 最适合 LibreChat 或其他网络化客户端。 | | 直接连接 (stdio) | 服务器通过标准输入/输出进行通信。 | 适用于本地测试或 Claude Desktop。 |

📚 详细文档

以下资源可帮助您深入了解 MCP：

📄 许可证

此项目 licensed under the GPLv3。有关详细信息，请参阅 LICENSE 文件。

mcp-server