MCP 服务器

一个让像 Claude 这样的 AI 助手安全地使用外部工具（例如运行 Python 代码或访问网站）的服务器。它处理数据，使其更容易被 AI 理解，并在出现问题时提供有用的错误消息，从而使机器人更有能力解决自己的问题。

1. 🛠️ 这个服务器提供哪些工具？
2. 🏎️ 如何运行它？
   1. 🐋 使用 Docker (推荐)
   2. 💻 本地运行
3. 🔌 如何连接
4. 📚 了解更多关于 MCP 的信息
5. 📄 许可证

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

一旦运行，你的 AI 助手将能够：

工具	它能做什么
Python	在沙箱中安全地运行 Python 代码。 包括用于数据分析的 numpy 和 pandas 等常用软件包，并且可以运行代码或检查其错误。
Web	访问网站并处理其内容。 可以将页面转换为易于阅读的 markdown，获取原始内容，或提取链接以帮助浏览文档。

🏎️ 如何运行它？

🐋 使用 Docker (推荐)

1. 如果你还没有安装 Docker，请安装 Docker

2. 创建一个名为 docker-compose.yml 的文件，内容如下：

   services:
   mcp-server:
      environment:
         - SSE_HOST=0.0.0.0
         - SSE_PORT=8080
         - USER_AGENT=CustomAgent/1.0
      image: ghcr.io/tcpipuk/mcp-server:latest
      restart: unless-stopped
      stop_grace_period: 1s
   

3. 运行 docker compose up 来启动服务器

注意: 当你设置 SSE_HOST 和 SSE_PORT 时，服务器将自动使用网络模式 (SSE)。 这是你与 LibreChat 一起使用时所需要的。

大多数人将其与以下两者之一一起使用：

• Claude Desktop - 直接连接到你的计算机
• LibreChat - 通过网络连接

对于 LibreChat，将此添加到你的 librechat.yaml 以进行连接：

mcpServers:
  mcp-server:
    iconPath: "/path/to/icon.png"
    type: sse
    url: http://mcp-server:8080/sse

💻 本地运行

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. 从 lockfile 安装依赖项：

   uv sync
   

4. 运行服务器：

   mcp-server --sse-host 0.0.0.0 --sse-port 3001 --user-agent "CustomAgent/1.0"
   

可用参数：

• --sse-host: SSE 监听地址 (例如 0.0.0.0)
• --sse-port: SSE 监听端口 (例如 3001)
• --user-agent: HTTP 请求的自定义 User-Agent 字符串

注意: 如果未提供任何 SSE 参数（或者未设置 SSE_HOST 或 SSE_PORT 环境变量），服务器将自动假定 stdio 模式并在标准 I/O 上监听。

🔌 如何连接

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

方法	它意味着什么	何时使用它
网络连接 (SSE)	服务器作为其他应用程序可以连接的服务运行	最适合大多数用户 - 尤其是 LibreChat
直接连接 (stdio)	服务器直接在你的计算机上运行	适用于测试或开发

📚 了解更多关于 MCP 的信息

以下是一些入门资源：

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

📄 许可证

本项目根据 GPLv3 许可证授权。 有关完整详细信息，请参阅 LICENSE 文件。