Tiburcio MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • Tiburcio 是一个基于 MCP 的后端服务器，专为 Claude Code 提供与代码库、架构、模式等相关的上下文与功能。通过 10 种 MCP 工具对资源、代码、架构、测试等信息进行检索和生成，确保回答来自团队实际知识库而非凭空想象。

• 主要功能点

  • 提供 10 种 MCP 工具，用于读取规范、检索代码、获取体系结构、查询数据库模式、查看夜间审查等，默认以紧凑模式输出，便于上下文窗口使用。
  • 提供会话管理、能力声明以及多传输协议支持（stdio、HTTP/SSE）。
  • 通过向量数据库（Qdrant）和混合检索（dense + BM25）实现高效、可控的检索结果。
  • 具备本地与 OpenAI 兼容模型的无缝切换，Embeddings、NLU 模型均可配置。
  • 提供 MCP 的 Admin、Auth、Chats 等路由，支持多协作团队环境。
  • 支持夜间与日间智能化流程（索引、审查、测试建议、图谱分析等）。

• 安装步骤

  • 准备环境：Node.js 22+、pnpm、以及可选的 Docker 组件（若使用容器化部署）。
  • 安装与编译（后端/后端依赖请在后端目录执行）：安装依赖并运行开发环境，确保后端服务能够启动并暴露 MCP 接入点。
  • 连接 Claude Code：
    • 本地 stdio（默认）连接方式：使用 Claude CLI 将 Tiburcio 作为 MCP 服务器接入。Claude Code 将通过 stdio 与 MCP 服务器通信。
    • HTTP/SSE 连接方式：在 Claude Code 的 MCP 设置中配置传输为 SSE，提供服务器地址与鉴权信息，Claude 将通过 HTTP/SSE 与 MCP 进行交互。
  • 启动方式（示意，不作为代码给出）：
    • stdio 连接：在后端安装好后，通过 Claude 的 “MCP/Add” 指令添加 tiburcio，并指定启动命令为运行 MCP 服务器的脚本（例如 npx tsx src/mcp.ts）。
    • SSE 连接：部署服务器后，在 Claude 客户端添加 tiburcio 连接，选择传输协议为 SSE，提供服务器地址与 Authorization 头（如 Bearer 令牌）等。

• 服务器配置（MCP 客户端使用，JSON 格式，含 server name、command、args 等信息）

  • serverName: tiburcio
  • command: "npx"
  • args: ["tsx", "src/mcp.ts"]
  • 注释：以上为本仓库在本地开发环境中 MCP 服务器的启动方式示例。若使用不同的启动脚本或容器部署，请按实际运行命令调整。客户端无需了解实现细节，只需读取 serverName、启动命令及参数信息即可建立连接。

• 基本使用方法

  • 连接成功后，通过 Claude Code 提出问题、调用工具、请求模板等，MCP 服务器将通过 JSON-RPC 请求并返回响应结果。
  • 如需切换传输方式，可在 Claude Client 设置中选择 stdio 或 SSE，并提供相应的连接信息与鉴权密钥。
  • 监控与运维：后端日志、队列和向量数据库状态可通过现有的日志与健康接口进行监控。