OWASP WrongSecrets MCP 服务端

使用说明内容(Markdown格式)

  • 项目简介

    • 该仓库实现了基于 Model Context Protocol (MCP) 的服务器端功能,核心职责是以标准化方式向 LLM 客户端提供上下文信息和功能,包括资源、工具和提示模板的管理、执行以及渲染。通过 JSON-RPC 进行请求/响应通信,支持会话管理和能力声明。
  • 主要功能点

    • 资源管理(Resources):托管和提供数据访问能力的资源集合。
    • 工具注册与执行(Tools):注册外部工具,并通过 MCP 客户端调用。
    • 提示模板(Prompts):定义与渲染用于 LLM 交互的提示模板。
    • JSON-RPC 通信:服务器端接收 JSON-RPC 请求并返回 JSON-RPC 响应,支持初始化、读取资源、调用工具、获取 Prompts 等操作。
    • 会话与能力声明:维护会话状态、能力宣告,以及对客户端能力的描述。
    • 多传输协议扩展:设计上应支持如 Stdio、SSE、WebSocket 等传输方式以便与不同客户端对接。
  • 安装步骤

    • 克隆或下载项目,进入项目根目录。
    • 构建并运行 MCP 服务器(与主应用服务器在同一应用中,通常在端口 8090 提供 MCP 服务;主应用在 8080)。
    • 在本地运行的示例命令(请根据实际环境选择合适的启动方式):
      • 使用 Maven 构建并运行:mvnw spring-boot:run -Dspring-boot.run.profiles=local
      • 直接以可执行包运行:java -jar target/your-app.jar --server.port=8090
    • 运行后,MCP 服务将对外提供 JSON-RPC 接口,客户端可通过标准化请求与之交互。
  • 服务器配置(MCP 客户端连接信息) 该部分用于 MCP 客户端向 MCP 服务器注册并建立连接的配置信息,格式为 JSON。客户端使用该信息来启动与 MCP 服务器的连接。请注意以下配置仅作为示例,实际部署时请以客户端文档为准。 { "serverName": "WrongSecrets MCP Server", "command": ["java", "-jar", "your-mcp-server.jar"], "args": [ "--server.port=8090", "--mcp.log.level=INFO", "--spring.profiles.active=production" ] // 备注:serverName 为 MCP 服务器的名称,command 为启动命令,args 为命令参数。MCP 客户端不需要额外的实现细节,只需要提供上述字段以便启动并连接到 MCP 服务器。 }

  • 基本使用方法

    • 启动并对接:启动 MCP 服务器后,客户端通过 JSON-RPC 向服务器发送请求(如 initialize、resources/read、tools/list、tools/call、prompts/get 等),服务器返回相应的 JSON-RPC 响应。
    • 资源与工具管理:客户端可查询可用的资源、查看已注册的工具并执行工具调用,获取并渲染提示模板以用于对话上下文扩展。
    • 会话与安全:服务器端负责会话管理与能力声明,确保上下文服务在多轮对话中的一致性与安全性。
    • 与主应用集成:MCP 服务器通常与主应用/客户端以 JSON-RPC 形式通信,便于 LLM 驱动的上下文服务无缝对接。

服务器信息