Skip to content

DEPLOY.md

Latest commit

 

History

History
141 lines (98 loc) · 3.34 KB

DEPLOY.md

File metadata and controls

141 lines (98 loc) · 3.34 KB
Raw

MCP框架本地Docker部署指南

本指南将帮助您使用Docker在本地部署支持图片处理的MCP服务器。

先决条件

  • 已安装Docker和Docker Compose
  • 基本的命令行操作知识

部署步骤

1. 准备环境变量文件

创建一个名为.env的文件在项目根目录中，内容如下：

# MCP服务器配置
MCP_SERVER_PORT=8000
MCP_SERVER_HOST=0.0.0.0
DEBUG=true

# MaxKB配置（可选，如果不使用可以留空）
MAXKB_HOST=http://host.docker.internal:8080
MAXKB_CHAT_ID=
MAXKB_APPLICATION_ID=
MAXKB_AUTHORIZATION=

# 本地文件挂载配置
# 修改HOST_MOUNT_SOURCE为您需要让MCP服务器访问的本地目录路径
# Mac/Linux示例: HOST_MOUNT_SOURCE=/Users/username/Documents
# Windows示例: HOST_MOUNT_SOURCE=C:/Users/username/Documents
HOST_MOUNT_SOURCE=/tmp
HOST_MOUNT_TARGET=/host_files

请根据您的实际情况修改HOST_MOUNT_SOURCE，指向您希望MCP服务器能够访问的本地目录。

2. 构建并启动Docker容器

在项目根目录中，运行以下命令：

# 构建Docker镜像并启动容器
docker-compose up -d

此命令会构建Docker镜像并在后台启动容器。

3. 验证服务是否正常运行

# 查看容器日志
docker-compose logs -f

如果看到如下类似输出，说明服务已成功启动：

mcp-server    | INFO:     Started server process [1]
mcp-server    | INFO:     Waiting for application startup.
mcp-server    | INFO:     Application startup complete.
mcp-server    | INFO:     Uvicorn running on http://0.0.0.0:8000

您也可以通过访问http://localhost:8000/sse验证服务是否正常运行。

4. 配置Claude或Cursor使用MCP服务器

在Claude Desktop中配置

  1. 打开Claude Desktop应用
  2. 点击左下角头像，选择"Settings..."
  3. 点击左侧"Developer"
  4. 点击"Edit Config"
  5. 输入以下配置：
{
  "mcpServers": {
    "custom-mcp": {
      "url": "http://localhost:8000/sse"
    }
  }
}

在Cursor中配置

  1. 在Cursor中打开命令面板（Ctrl+Shift+P或Cmd+Shift+P）
  2. 输入"MCP"并选择"MCP: Configure MCP Server"
  3. 选择"Add New Server"
  4. 选择"SSE Server"类型
  5. 输入URL: http://localhost:8000/sse
  6. 输入名称，如"custom-mcp"

5. 测试文件处理和图片支持

在Claude Desktop或Cursor中，尝试以下操作：

  • 解析PDF文件：请解析这个PDF文档：/path/to/your/document.pdf
  • 解析Word文档：请解析这个Word文档：/path/to/your/document.docx

如果一切正常，您应该能够看到文档内容以及其中包含的图片。

管理Docker容器

# 停止服务
docker-compose down

# 查看容器状态
docker-compose ps

# 重启服务
docker-compose restart

常见问题排查

1. 无法访问主机文件

确保您在.env文件中正确设置了HOST_MOUNT_SOURCE，指向您需要访问的目录。

2. 图片无法显示

检查服务器日志是否有错误信息。可能是Tesseract OCR依赖问题，可以尝试手动进入容器安装：

docker exec -it mcp-framework_mcp-server_1 bash
apt-get update && apt-get install -y tesseract-ocr tesseract-ocr-chi-sim tesseract-ocr-eng

3. MCP服务器无法启动

检查端口是否被占用：

lsof -i :8000

如果端口被占用，可以在.env文件中修改MCP_SERVER_PORT为其他值。