使用说明（Markdown 格式）

项目简介

这是一个基于 MCP（Model Context Protocol）的后端服务器实现，设计目标是向大语言模型客户端提供标准化的资源、工具和提示模板，并通过JSON-RPC风格的请求/响应进行交互。
服务器支持多传输模式（STDIO 和 HTTP），可在本地 IDE 集成或云端部署使用。

主要功能点

内置 18 个后端工具用于项目、模式、部署等管理（18 工具包括 11 个读取操作和 7 个写入操作）。
资源管理：可列出并读取静态文档资源，提供快速帮助与参考文档。
提示模板：提供如创建项目、修复模式等后台提示（Prompts），支持自定义处理程序。
认证与安全：通过 API Key 进行请求鉴权；STDIO 模式要求在启动时提供 API Key，HTTP 模式按请求 Bearer Token 进行鉴权。
双传输模式：STDIO（本地 IDE、Cursor/VS Code/ Claude Desktop 等）和 HTTP（云部署、Smithery、Replit 等）两种模式，满足不同场景需求。
客户端对接：通过统一的工具执行接口，将工具调用的结果以文本形式返回给客户端，并支持错误处理与日志输出。

安装步骤

系统要求：Python 3.10 及以上。
安装：
- 使用 pip 安装依赖：pip install rationalbloks-mcp
运行前准备：
- STDIO 模式：需要设置环境变量 RATIONALBLOKS_API_KEY（示例 rb_sk_your_key_here），以便启动时进行密钥校验。
- HTTP 模式：可以不设置 RATIONALBLOKS_API_KEY，传输模式切换为 http。
启动服务器（示例命令，会根据 TRANSPORT 环境变量选择模式）：
- STDIO 模式（本地 IDE 集成）：
  - export RATIONALBLOKS_API_KEY=rb_sk_your_key_here
  - rationalbloks-mcp
- HTTP 模式（云端/容器部署）：
  - export TRANSPORT=http
  - 可选：export HOST=0.0.0.0
  - export PORT=8000
  - rationalbloks-mcp

服务器配置（MCP 客户端需要的启动信息）说明：MCP 客户端需要一个启动配置，包含服务器名称、启动命令及参数。以下 JSON 格式示例可用于客户端配置，配置时请尽量与实际部署一致。

STDIO 模式 { "server_name": "rationalbloks-backend", "command": "rationalbloks-mcp", "args": { "transport": "stdio" }, "notes": "该模式需要在启动前设置环境变量 RATIONALBLOKS_API_KEY，其值类似 rb_sk_...；客户端通过 STDIO 与 MCP 服务器交互。" }
HTTP 模式 { "server_name": "rationalbloks-backend", "command": "rationalbloks-mcp", "args": { "transport": "http", "HOST": "0.0.0.0", "PORT": 8000 }, "notes": "该模式通过 HTTP/SSE 进行通信。若在云环境，端口需暴露并通过负载均衡器/网关访问。" }

基本使用方法

启动后，MCP 服务器将对接大语言模型客户端，客户端可以通过工具名执行相应操作，如列出项目、创建项目、读取模式、检查任务状态等。
使用时，客户端通过 JSON-RPC 风格的请求调用注册的工具名称（如 list_projects、create_project 等），服务器返回结果或错误信息。
调试与运维要点：
- STDIO 模式下，确保环境变量 RATIONALBLOKS_API_KEY 已设置且格式正确。
- HTTP 模式下，确保端口可访问，若有鉴权，提供 Bearer token 即可。
- 监控日志输出，遇到错误时查看服务器端报错信息，定位是参数问题、权限问题还是网络请求问题。

RationalBloks MCP 服务器