Crust MCP网关服务器

使用说明

• 项目简介 Crust 提供一个 MCP 网关/后端，用于在本地搭建一个标准化的上下文服务层，向 LLM 客户端提供资源读取、工具注册与调用、以及提示模板的渲染等能力，并通过内置的规则引擎对访问进行安全控制。

• 主要功能点

  • 与 MCP 客户端以 JSON-RPC 进行通信，处理读取资源、注册/执行工具、获取/渲染提示等请求。
  • 拦截并评估工具调用和资源读取等行为，应用自带的安全规则与 DLP 检测，保护本地数据和敏感信息。
  • 支持 MCP 的多种传输入口：标准输入输出（Stdio）网关、HTTP（Streamable HTTP）网关，以及在 ACP 场景中的集成代理。
  • 提供 MCP 网关、MCP HTTP 网关等不同入口，方便将现有 MCP 服务器接入 Crust 的规则引擎。

• 安装步骤

  • 从源码构建：下载安装 Go 1. 更高版本的 Go，克隆仓库后执行 go build .
  • 运行网关：示例命令 crust mcp gateway -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir
  • 也可结合已有 MCP 服务器，使用 --endpoint 指定上游 MCP 服务器地址，或使用 --auto 自动推断提供者。

• 服务器配置 (MCP客户端需要的最小启动信息) 说明：以下 JSON 配置用于 MCP 客户端在本地化部署中调用启动服务。字段含义如下：server_name 为服务标识；command 为启动 Crust 的可执行文件名；args 为启动参数列表，描述该网关如何对接上游 MCP 服务器。具体地址、密钥等配置请结合实际环境与服务器配置文件进行调整。 { "server_name": "crust-mcp-gateway", "command": "crust", "args": [ "start", "--block-mode", "replace", "--proxy-port", "9090", "--endpoint", "http://<upstream-mcp-server>/api" // 如有上游 MCP 服务器地址，请替换 ] } 说明：该配置仅用于启动网关的最小示例，实际部署中可按需要添加 --config、--endpoint、--api-key 等参数，Crust 的 MCP 网关也支持自动探测提供者、以及上游端点的覆盖配置。

• 基本使用方法

  • 启动网关后，它将作为本地 MCP 服务的入口，MCP 客户端连接 Crust 提供的服务端口，进行工具调用、资源读取以及上下文交互。
  • 通过 Crust 的网关，可以对 MCP 服务器的工具和资源访问进行安全控制、监控与日志记录。
  • 若要使用 HTTP 网关或 ACP 集成，请参考仓库中的相关文档（MCP Gateway、ACP 集成等部分）。

• 注意事项

  • 运行前请确保上游 MCP 服务器可访问，若使用 Auto 模式，请确保模型名称能被正确解析。
  • 使用时建议开启自带的规则引擎与日志，以便对风险动作进行追踪与审计。

• 进一步使用

  • 参考仓库文档中的 MCP 相关指南，结合实际 MCP 服务器及代理方式进行部署与集成。