使用说明（摘要）

• 项目简介
  • 该仓库实现一个 MCP 服务器（服务端），用于向 LLM 客户端提供上下文相关的资源、工具和提示模板，支持 JSON-RPC 交互，具备会话管理、能力声明和多传输协议的扩展能力。
• 主要功能点
  • 资源和数据访问：通过数据库后端提供资源/集合的创建、查询、更新、删除等能力，以及统计和索引管理。
  • 工具注册与调用：暴露工具集（如插件、管理员工具等）的注册、查询和执行能力，支持权限控制。
  • 提示模板管理：提供 prompts 的列表、获取与渲染，方便 LLM 进行对话模板化交互。
  • JSON-RPC 通信：遵循 MCP 的请求/响应模型，支持初始化、工具调用、促使 Prompts 内容、提示获取等请求。
  • 会话与权限：内置会话上下文、API Key / Admin Key 的认证与授权，支持安全访问控制。
  • 多传输与扩展性：提供基于 HTTP 的 MCP 服务，未来可扩展到 STDIO/SSE/WebSocket 等传输模式。
• 安装步骤
  • 使用编译后的 MCP 服务器二进制在目标平台直接运行（仓库包含 Windows/Linux/macOS 的 MCP 服务器发行说明），或自行编译源码安装。
• 服务器配置（JSON 配置示例，供 MCP 客户端在本地连接时读取） serverName: "ironbase-mcp" 命令与参数（command 与 args，供 MCP 客户端启动时创建连接使用） { "serverName": "ironbase-mcp", "command": "mcp-ironbase-server", "args": ["--port", "8080", "--host", "0.0.0.0"] } 注释说明：
  • serverName 为 MCP 服务实例的唯一标识，便于客户端在多服务中区分。
  • command 为服务器启动命令名（不包含路径，以便跨平台使用的描述）。
  • args 为启动参数列表，常见包含端口、主机及可选的 TLS/认证相关选项，具体请结合部署环境配置。
• 基本使用方法
  • 启动服务器：执行服务器可执行文件，监听指定端口。
  • 客户端连接：按上述配置提供的 serverName、command、args，在 MCP 客户端中配置连接，使用 JSON-RPC 2.0 请求调用工具、获取 Prompts、读取资源等。
  • 请求示例（描述性文本，不含代码块）：
    • initialize 请求：向 MCP 服务器发送初始化请求，声明协议版本与可用能力。
    • tools/call 请求：调用注册的工具，传入工具名与参数，服务器返回执行结果或错误信息。
    • prompts/list/get 请求：获取可用的 Prompts 列表或具体 Prompt 内容，用于渲染对话模板。
  • 运行中的维护：如需停机、升级等，遵循服务器自身的服务管理命令（如 install/start/stop 等），确保在维护期做好会话上下文与数据一致性处理。
• 备注
  • MCP 客户端实际使用时通常不需要暴露底层实现细节，但需掌握配置格式与接口调用方式。该实现提供完整的工具与 Prompts 管理、资源访问、会话与鉴权等能力，适合作为 LLM 的上下文服务后台。