Containarium MCP Server
使用说明(简要要点,便于快速落地):
- 项目简介
- Containarium 在 MCP 框架下实现了对资源、工具与提示模板等能力的对接,提供一个可与你的 MCP 客户端对话的服务器端组件。
- 通过 JSON-RPC 的 MCP 规范与 LLM 客户端通信,支持将上下文、资源访问能力和工具执行能力暴露给客户端。
- 主要功能点
- MCP 核心能力:接收 MCP 风格的请求,返回标准化的 JSON-RPC 响应,支持资源、工具与提示模板等上下文服务的访问。
- 会话与能力声明:服务器端维护会话状态、能力声明,确保客户端能基于声明的能力进行对话与功能调用。
- 多传输协议适配:支持标准 MCP 交互模式,设计上可扩展为多种传输协议(如 Stdio、SSE、WebSocket 等)。
- 与 Claude Desktop 等 MCP 客户端的集成:提供文档与示例,便于将 MCP 服务器接入现有的 ML 客户端工作流。
- 安全与认证:通过配置服务器地址与 JWT/证书等方式实现访问控制,确保与 LLM 客户端的安全通信。
- 安装步骤
- 下载源码并查看依赖。确保已经安装 Go 开发环境。
- 构建 MCP 服务器可执行文件(示例命令:make build-mcp,或直接使用 go build 构建 cmd/mcp-server/main.go)。
- 启动 MCP 服务器(在支持的环境中,可以通过系统服务或直接运行生成的二进制)。
- 使用 Claude Desktop(或其他 MCP 客户端)配置 MCP 服务器的连接信息,按以下配置示例提供服务器名称、命令路径、以及环境变量。
- 服务器配置(MCP 客户端需要的配置信息,JSON 格式,描述服务器名称、启动命令与参数等)
- serverName: "containarium"(MCP 客户端在配置中使用的服务器标识)
- command: "/usr/local/bin/mcp-server"
- args: [](根据实际部署需要添加参数,例如 --mtls、--rest 等)
- env:
- CONTAINARIUM_SERVER_URL: "http://localhost:8080"(MCP 客户端与后端交互的网关地址)
- CONTAINARIUM_JWT_TOKEN: "<your-jwt-token>"(REST API 认证令牌,若使用 REST 模式) 注释:
- 以上字段需结合仓库中的实际启动方式与证书/认证机制来配置,MCP 客户端只需要读取此 JSON 配置并启动对应的 MCP 客户端连接,不需要在 MCP 客户端中实现服务器逻辑。
- 基本使用方法
- 构建并启动 MCP 服务器后,确保服务器对 Claude Desktop 等 MCP 客户端可访问(通过配置中的 ServerURL 与鉴权信息)。
- 在 Claude Desktop 中添加一个 MCP 服务器条目,指定命令路径和环境变量,以便它可以启动并通过 MCP 规范与 Containarium 进行请求/响应交互。
- 使用 MCP 客户端发起对资源、工具、Prompts 的请求,服务器按 MCP 协议返回 JSON-RPC 响应。