MCP Server

MCP Server

site icon
2025.03.28 0
PythonAI工具集成Python沙箱网页访问开发效率
MCP Server 是一个允许AI助手(如Claude)安全使用外部工具(如运行Python代码或访问网站)的服务器。它处理数据以使其更易于AI理解,并在出现问题时提供有用的错误消息,从而增强AI自主解决问题的能力。
View on GitHub

Overview

基本能力

产品定位

MCP Server 是一个为AI助手提供外部工具访问能力的中间件服务器,旨在增强AI的功能性和自主性。

核心功能

  1. Python工具:在沙箱中安全运行Python代码,支持包括numpy和pandas在内的流行数据分析包,可以运行代码或检查错误。
  2. Web工具:访问网站并处理其内容,可以将页面转换为markdown格式以便阅读,获取原始内容或提取链接以帮助导航文档。

适用场景

  1. AI助手需要执行Python代码进行数据分析或自动化任务。
  2. AI助手需要访问和解析网页内容以获取信息。
  3. 开发者在开发AI应用时需要扩展AI的功能性。

工具列表

  1. Python工具:提供Python代码的沙箱执行环境,支持常见数据分析库。
  2. Web工具:提供网页访问和内容处理能力,支持多种内容格式转换。

常见问题解答

  1. 如何选择连接方式?:网络连接(SSE)适用于大多数用户,尤其是与LibreChat配合使用;直接连接(stdio)适用于测试或开发。
  2. 如何更新uv工具?:运行 uv self update 命令即可更新。

使用教程

使用依赖

  1. Docker安装:确保已安装Docker,参考Docker安装指南
  2. Python环境:需要Python 3.13+,并安装uv工具。

安装教程

使用Docker(推荐)

  1. 创建docker-compose.yml文件并填入以下内容: yaml 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
  2. 运行 docker compose up 启动服务器。

本地运行

  1. 安装uv工具: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 创建并激活虚拟环境: bash uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
  3. 安装依赖: bash uv sync
  4. 运行服务器: bash mcp-server --sse-host 0.0.0.0 --sse-port 3001 --user-agent "CustomAgent/1.0"

调试方式

  1. 网络连接(SSE):确保服务器运行并监听指定端口(如8080),检查网络连接是否正常。
  2. 直接连接(stdio):确保服务器运行在标准I/O模式,检查输入输出是否正确。

许可证

该项目遵循 GPL-3.0 开源许可条款,请参阅 GPL-3.0 了解完整条款。