liblib

Liblib MCP Server 提供一个单端口的统一 HTTP 服务，基于 mark3labs/mcp-go 实现的 MCP 协议，结合 Liblib 平台的 ComfyUI 工作流，能够以多租户方式动态发布为 MCP Tools。通过管理界面、鉴权和 Bearer Token 机制，用户可以注册工作流、管理密钥并自动生成对应的 MCP Tools，方便地在 MCP 客户端中调用。系统还提供工具自动解析参数结构、参数验证以及基于用户密钥的工具执行隔离，确保每个租户的工作流和工具在逻辑与数据上分离。

快速开始需要具备 Docker 或源码部署的环境。下面给出两种常见安装方式：

Prerequisites:

• Docker 或 Go 1.23+ 环境（若从源码部署，需安装 Go、Node.js、Git、以及前端构建所需工具）
• 访问端口 8080（默认）或在配置中自定义端口

方式1：Docker 部署（推荐）

1. 拉取镜像并启动

docker pull ccr.ccs.tencentyun.com/yfgaia/liblib-mcp-server:latest
docker run -d -p 8080:8080 -v $(pwd)/data:/app/data -v $(pwd)/logs:/app/logs --name liblib-mcp-server ccr.ccs.tencentyun.com/yfgaia/liblib-mcp-server:latest

2)（可选）使用 Docker Compose 部署

docker-compose -f docker-compose.prod.yml up -d

方式2：从源码部署

1. 安装依赖并获取代码

# 克隆仓库
git clone https://github.com/WW-AI-Lab/liblib-mcp-server.git
cd liblib-mcp-server

2. 构建后端

go mod download
go build -o bin/server ./cmd/server

3. 构建前端（如需本地开发/修改前端）

cd web
npm install
npm run build
cd ..

4. 复制环境配置模板并编辑

cp config.env.example config.env
# 编辑 config.env 填入必要配置，如 MCP_KMS_KEY、JWT_SECRET 等

5. 启动服务

./bin/server

配置后，默认入口为 http://localhost:8080，后续可通过管理界面进行密钥管理、工作流注册以及 MCP Tool 的生成与调用。

• 需要正确配置密钥相关的环境变量，例如 MCP_KMS_KEY 与 JWT_SECRET，确保数据加密与 token 签名的安全性。
• 默认单端口架构，前端资源通过静态文件服务提供，生产环境建议使用 HTTPS 及反向代理。
• 如果遇到数据库连接问题，请检查 DB_TYPE、DB_PATH、以及对应的数据库驱动是否安装。
• Startup 时若端口冲突，请在 config.env 中修改 PORT 值或在运行命令中覆盖端口映射。
• MCP 连接示例与密钥管理示例在 API 文档中有详细描述，请按照要求提供 Bearer Token 以完成认证。