CorvidAgent MCP 服务器

使用说明（简要概览，便于快速接入和理解）

• 项目简介
  • 该仓库实现了一个基于 MCP（Model Context Protocol）的后端服务，核心职责是以标准化的方式向 LLM 客户端提供上下文信息与能力，包括资源（Resources）的托管与访问、工具（Tools）的注册与执行，以及提示模板（Prompts）的定义与渲染。服务器通过 JSON-RPC/REST 方式与客户端通信，能通过多种传输协议（如 Stdio、SSE、WebSocket）实现实时上下文服务。
• 主要功能点
  • 资源与数据访问：对资源进行托管、查询与版本控制，支持多租户隔离。
  • 工具注册与执行：提供 corvid_* 工具集的统一注册与执行入口，允许 LLM 客户端调用外部功能。
  • 提示模板与渲染：定义与渲染 Prompt 模板，支持可定制化的 LLM 交互模式。
  • MCP API 与路由：包含 ~200 REST/API 路由，以及用于 MCP 客户端通信的端点，支持 MCP 指南中的工具、资源、Prompts 的访问与执行。
  • 安全与可扩展性：会话管理、能力声明、以及对接多传输协议（HTTP / WebSocket / SSE 等），具备多租户隔离、审计与可观测性支持。
• 安装与运行步骤
  • 先决条件：安装 Bun 运行时（仓库自带 Bun 相关脚本）。
  • 获取代码并进入项目目录后，执行以下步骤（以 Bun 为例）：
    • bun install
    • bun run dev
  • 服务器启动后，默认暴露在 http://localhost:3000 上，具体端口可通过环境变量 PORT 改写。
• 服务器配置（MCP 客户端连接信息，供 MCP 客户端参考）
  • JSON 配置示例（用于 MCP 客户端启动连接服务器的元信息说明，客户端实现不需要代码，只需读取此概念配置并据此启动连接）： { "serverName": "corvid-agent-mcp", "transport": "WebSocket", "startCommand": "bun", "startArgs": ["run", "dev"], "address": "http://localhost:3000", "description": "CorvidAgent MCP 服务端，提供资源、工具与提示模板的 MCP 能力", "version": "0.20.0" }
  • 注释说明：上述字段用于 MCP 客户端在启动时明确服务器实例的名称、启动方式（命令与参数）、通信传输协议，以及服务器地址等元信息，客户端端点会据此建立 JSON-RPC/WebSocket 连接并进行资源、工具、Prompts 的交互。
• 基本使用方法
  • 启动服务后，MCP 客户端通过服务器暴露的传输通道进行请求，例如读取资源、调用工具、获取或渲染 Prompt。
  • 客户端应遵循 MCP 的标准请求格式（JSON-RPC），服务端返回相应的 JSON-RPC 结果或通知。
  • 如需扩展能力，可在服务器端新增工具/资源类型，并通过 MCP 路径暴露给客户端使用。