使用说明

• 项目简介

  • MingAI MCP Server 是一个完整的 MCP 服务器实现，按照 MCP 协议处理请求与响应，提供工具调用、资源/知识库、提示模板等能力，服务端负责会话管理与能力声明，并支持多种传输协议（如 Streamable HTTP）。

• 主要功能点

  • MCP 核心能力：支持工具注册/查询、通过 JSON-RPC 接口执行工具、返回结构化数据或 Markdown 文本格式的响应。
  • 安全与鉴权：内置 OAuth 2.1 认证、基于 API Key 的鉴权、会话级别管理与请求限流、SSE 并发控制等安全/性能特性。
  • 会话与传输：本地可通过 stdio（packges/mcp-local）或流式 HTTP（Streamable HTTP）进行 MCP 会话的创建、管理与清理。
  • 工具分发与渲染：集中管理并暴露 MCP Tools，提供格式化渲染器，将 JSON 结果转为 Markdown 提示文本，便于人类阅读。
  • 服务器端实现：包含服务端主入口、中间件、OAuth 提供者、Supabase 集成及多处理器模块，具备实际运行能力。
  • 参考实现仓库内包含前端/后端示例、完整的 MCP 服务端逻辑及工具实现，适合作为 MCP 服务端落地方案。

• 安装步骤（简要）

  • 运行环境要求：Node.js、pnpm/npm/yarn、Docker（如使用 Docker 配置参考 README）。
  • 本仓库提供 Docker 部署方案，亦可本地开发运行。
  • 按仓库的 Quick Start 指引完成部署（例如使用 docker compose 同时启动 Web 与 MCP 服务，或分别启动）。

• 服务器配置（供 MCP 客户端连接使用的描述）

  • 服务器端运行命令（示例，实际部署请按环境配置执行）：
  • 服务器名称：mingai-mcp-online
  • 启动命令：node
  • 启动参数：packages/mcp-server/dist/index.js
  • 说明：该服务为 MCP Server Online 实现，需在环境变量中配置 MCP_JWT_SECRET、MCP_ISSUER_URL、SUPABASE_URL、SUPABASE_ANON_KEY 等，用于鉴权、数据存取与授权流程。部署时可参考仓库中的 Docker 部署或 README 的配置说明。
  • 注：MCP 客户端在连接该服务器时需提供 JSON 配置，至少包含服务器标识、连接参数等信息（客户端配置在此处不展示实现细节，具体请参考 MCP 客户端接入指南）。

• 基本使用方法

  • 启动后，客户端通过 MCP JSON-RPC 协议向该服务器发起请求，例如读取工具、执行工具、获取 Prompts 等。
  • 服务器端会返回标准的 MCP JSON-RPC 响应，或通过通知/事件推送提供上下文与结果。
  • 如需本地调试，可使用 packages/mcp-local 提供的本地 stdio 服务器进行交互。

• 备注

  • 本项目包含完整的服务端实现、OAuth 提供者、Supabase 集成与多种工具实现（如 bazi, ziwei, liuyao, tarot, daily fortune, dayun 等），具备运行能力与明确的分层结构，非单纯示例。