MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

MCP Server 旨在为AI助手提供网络访问和搜索能力，使其能够获取实时信息并处理网页内容。

核心功能

• 搜索工具：通过SearXNG搜索网络，获取当前信息、特定资源或进行计算。
• 网页访问工具：访问网站并处理其内容，包括将页面转换为Markdown、获取原始内容或提取链接。

适用场景

• AI助手需要获取实时网络信息时。
• 需要处理网页内容（如转换为Markdown或提取链接）时。
• 在开发环境中集成网络搜索和访问功能时。

工具列表

1. Search工具：通过SearXNG进行网络搜索，适用于获取实时信息或特定资源。
2. Web工具：访问并处理网页内容，支持转换为Markdown、获取原始内容或提取链接。

常见问题解答

• 如何配置SearXNG：必须提供SEARXNG_QUERY_URL环境变量，指向SearXNG实例的搜索API端点。
• 网络模式与stdio模式的区别：网络模式（SSE）适用于多容器设置（如LibreChat），而stdio模式适用于本地测试或Claude Desktop。

使用教程

使用依赖

1. 安装Docker（推荐）或Python 3.13+（本地运行）。

安装教程

Docker方式（推荐）

1. 创建docker-compose.yml文件并配置环境变量（如SEARXNG_QUERY_URL）。
2. 运行以下命令启动服务：
   bash
docker compose up -d

本地运行方式

1. 安装uv工具：
   bash
curl -LsSf https://astral.sh/uv/install.sh | sh
2. 创建并激活虚拟环境：
   bash
uv venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
3. 安装依赖：
   bash
uv sync
4. 设置环境变量并运行服务：
   bash
export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080"
mcp-server --sse-host 0.0.0.0 --sse-port 3001 # 网络模式
mcp-server # stdio模式

调试方式

• 检查Docker容器日志：
  bash
docker logs mcp-server
• 本地运行时查看控制台输出。
• 确保SEARXNG_QUERY_URL正确配置。