MCP开发框架

MCP开发框架

一个强大的MCP（Model Context Protocol）开发框架，用于创建与大语言模型交互的自定义工具。

GitHub
Created Byw-jeonw-jeon

快速入门

安装

  1. 克隆仓库： git clone https://github.com/w-jeon/mcp-framework.git cd mcp-framework
  2. 创建环境文件： cp .env.example .env

使用 Docker 部署（推荐）

  1. 构建并启动服务： docker compose up --build -d
  2. 查看日志： docker compose logs -f
  3. 访问服务：http://localhost:8000/sse

传统 Python 部署

  1. 安装系统依赖（以 Ubuntu 为例）： sudo apt-get update sudo apt-get install -y poppler-utils tesseract-ocr tesseract-ocr-chi-sim
  2. 创建虚拟环境并安装依赖： python -m venv venv source venv/bin/activate pip install -r requirements.txt
  3. 启动服务： python -m mcp_tool

配置

在 .env 文件中设置以下变量：

  • MCP_SERVER_PORT: 服务端口，默认 8000
  • MCP_SERVER_HOST: 绑定地址，默认 0.0.0.0

开发新工具

  1. 在 tools 目录下创建新工具文件。
  2. 注册工具类并实现 execute 方法。
  3. 使用 @ToolRegistry.register 装饰器注册工具。