Longbridge MCP Docker

长桥mcp docker

](https://github.com/metaif/longbridge-mcp-docker/actions/workflows/docker-build-test.yml) ](https://www.docker.com/) 

英语| 简体中文

用于Longbridge MCP（模型上下文协议）服务器的Docker包装器，提供Longport API服务的轻松部署和管理。

概述

此项目打包了 longport-mcp 服务器在Docker容器中，通过正确的配置管理、日志记录和健康检查，部署和运行Longport API服务变得简单。

特性

• 🐳 基于Docker的部署 -使用Docker Compose轻松设置
• 📦 预构建图像 -通过GitHub容器注册表提供多架构映像
• 🔒 安全配置 -基于环境变量的凭证管理
• 📊 持续日志记录 -日志存储在已装载的卷中
• 💚 健康监测 -内置健康检查，确保服务可靠性
• 🔄 自动重启 -故障时自动重启容器
• 🏗️ 多架构支持 -同时支持x86_64和aarch64（ARM64）

先决条件

• Docker引擎（20.10.0或更高版本）
• Docker Compose（1.29.0或更高版本）
• 长端口API凭据（APP_KEY、APP_SECRET、ACCESS_TOKEN）

快速开始

选项1：使用预构建映像（推荐）

直接使用GitHub容器注册表中的预构建映像：

# Pull the latest version
docker pull ghcr.io/metaif/longportmcpdocker:latest

# Or pull a specific version
docker pull ghcr.io/metaif/longportmcpdocker:v1.0.0

# Run directly
docker run -d \
  --name longport-mcp-server \
  -e LONGPORT_APP_KEY=your_app_key \
  -e LONGPORT_APP_SECRET=your_app_secret \
  -e LONGPORT_ACCESS_TOKEN=your_access_token \
  -e LONGPORT_READONLY=true \
  -p 8000:8000 \
  -v ./logs:/var/log/longport-mcp \
  ghcr.io/metaif/longportmcpdocker:latest

选项2：从源代码构建

1.克隆存储库

git clone https://github.com/metaif/longbridge-mcp-docker.git
cd longbridge-mcp-docker

2.配置环境变量

创建一个 .env 项目根目录中的文件：

# Longport API Credentials (Required)
LONGPORT_APP_KEY=your_app_key_here
LONGPORT_APP_SECRET=your_app_secret_here
LONGPORT_ACCESS_TOKEN=your_access_token_here

# Server Configuration (Optional)
SERVER_PORT=8000
LONGPORT_READONLY=true

3.构建并启动服务

# Build the Docker image
docker-compose build

# Start the service
docker-compose up -d

4.验证服务

# Check service status
docker-compose ps

# View logs
docker-compose logs -f longport-mcp

# Check health status
docker-compose exec longport-mcp nc -z localhost 8000 && echo "Service is healthy"

配置

环境变量

只读模式

默认情况下，服务以只读模式运行(LONGPORT_READONLY=true)以防止意外修改。设置为 false 要启用写入操作，请执行以下操作：

LONGPORT_READONLY=false

项目结构

longbridge-mcp-docker/
├── docker-compose.yml    # Docker Compose configuration
├── Dockerfile           # Docker image definition
├── entrypoint.sh       # Container startup script
├── README.md           # This file
├── .env               # Environment variables (create this)
└── logs/              # Log files (auto-created)
    └── longport-mcp.log.*

用法

启动服务

docker-compose up -d

停止服务

docker-compose down

重新启动服务

docker-compose restart

查看日志

# Follow logs in real-time
docker-compose logs -f

# View recent logs
docker-compose logs --tail=100

# View logs from host directory
tail -f logs/longport-mcp.log.*

变更后的重建

docker-compose down
docker-compose build --no-cache
docker-compose up -d

访问服务

该服务为MCP通信公开了一个HTTP端点：

• 默认URL: http://localhost:8000
• 协议：服务器发送事件（SSE）

您可以配置MCP客户端以连接到此端点。

健康检查

该容器包括自动健康检查，包括：

• 每30秒测试一次与端口8000的连接
• 开始检查前等待40秒
• 失败时最多重试3次
• 如果检查失败，将容器标记为不健康

检查健康状况：

docker inspect longport-mcp-server --format='{{.State.Health.Status}}'

故障排除

容器无法启动

1. 检查是否设置了所需的环境变量：

   docker-compose config

1. 验证凭据是否正确 .env 文件

1. 检查日志以获取详细的错误消息：

   docker-compose logs

端口已在使用中

如果端口8000已被占用，请更改 SERVER_PORT 在 .env:

SERVER_PORT=8001

日志的权限问题

确保 logs/ 目录具有适当的权限：

chmod 755 logs/

安全考虑

• ⚠️ 永不承诺 .env 文件 -添加到 .gitignore
• 🔐 使用只读模式 在生产中默认
• 🔒 保护您的API证书 -将Docker机密或加密存储用于生产
• 🌐 防火墙配置 -如果公开，则限制对服务端口的访问

构建最小图像

要在没有Docker Compose的情况下创建最小的Docker镜像：

docker build -t longport-mcp:mini .

手动运行：

docker run -d \
  --name longport-mcp-server \
  -p 8000:8000 \
  -e LONGPORT_APP_KEY=your_key \
  -e LONGPORT_APP_SECRET=your_secret \
  -e LONGPORT_ACCESS_TOKEN=your_token \
  -e LONGPORT_READONLY=true \
  -v $(pwd)/logs:/var/log/longport-mcp \
  longport-mcp:mini

架构支持

此项目自动检测并支持以下架构：

• x86_64 （英特尔/AMD 64位）
• aarch64 （ARM 64位，包括苹果硅）

在Docker构建过程中下载正确的二进制文件。

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目是 长端口MCP服务器。请参阅原始项目以获取许可信息。

链接

• Longport API文档
• 模型上下文协议

支持

关于以下问题：

• 这个Docker包装器：在此存储库中打开一个问题
• 长端口MCP服务器：访问 官方存储库
• API长港：联系方式 长端口支持

______________________________________________________________________

由以下材料制成❤️ 为Longport社区