Decibel Tools MCP 服务器

使用说明内容（Markdown格式）

• 项目简介
  • 该仓库实现了一个基于 MCP 的服务器端，核心通过内核（Kernel）分发工具，向 LLM 客户端提供对资源、工具和提示模板的统一访问入口，支持多域工具集（如 Sentinel、Designer、Architect、Dojo、Oracle 等），并通过 JSON-RPC、标准 I/O、HTTP 以及桥接模式进行通信，具备会话管理和能力声明能力。
• 主要功能点
  • 资源管理：通过 .decibel 目录结构托管和管理数据资源（issues、epics、ADRs、context、sentinel 等），支持本地化数据存储与跨路径合并读取。
  • 工具注册与执行：实现了多域工具集（Sentinel、Architect、Designer、Dojo、Oracle 等）的注册、查询与执行能力，支持 Facade 调用以及直接工具调用，返回结构化 JSON 结果。
  • Prompt 模板与交互：定义并渲染工具提示和前端展示的描述，提供统一的工具描述、输入输出结构，方便 LLM 进行对话式调用。
  • MCP 协议实现：遵循 MCP 的请求/响应模式，提供初始化、列工具、执行工具、批量调用等核心能力，支持错误处理与诊断信息。
  • 多传输协议支持：包括标准输入输出的 stdio 模式、HTTP 模式，以及与守护进程的 bridge 模式，能够通过不同传输层与客户端通信。
  • 会话与安全：包含会话管理、能力声明、许可门控（ProGate）、以及按需的安全检查与日志记录，便于在本地环境中以最少外部依赖运行。
• 安装步骤
  • 获取代码并安装依赖（如 npm install），构建 dist/server.js（若以源码方式运行可用 ts-node/tsx 直接启动）。
  • 启动方式示例（stdio 模式）：node dist/server.js
  • 也可通过 HTTP 模式启动：node dist/server.js --http
  • 如需守护进程/桥接，请参考仓库中的文档说明使用 --daemon、--bridge 等参数启动。
• 服务器配置（供 MCP 客户端使用的配置信息，示例为 JSON，描述 server 的启动命令与参数） { "serverName": "decibel-tools-mcp", "command": "node", "args": ["dist/server.js"], "description": "MCP 服务器，提供资源、工具与提示模板服务的后端", "notes": "客户端在建立连接时需提供服务器路径及启动参数，常见模式包括 stdio、HTTP 和 bridge。" } 说明：上述配置仅用于 MCP 客户端在启动时指定服务器进程的启动命令与参数。实际连接时客户端会根据具体需求选择 stdio/HTTP/桥接等传输方式。
• 基本使用方法
  • 启动服务后，使用 MCP 客户端与服务器进行通信，执行列出工具、调用工具、获取 epics/issues/ADRs 等操作。
  • 与 Cursor/ Claude 等集成时，依据对应客户端的连接配置，将服务器路径和传输模式配置到客户端，以实现无缝的上下文服务访问。