Rs4it MCP

RS4IT MCP集线器

RS4IT MCP Hub是一个 模型上下文协议（MCP） 服务器，通过单个端点向AI客户端（例如Cursor、Claude、带MCP的VS Code）公开您组织的工具和集成。

这个repo是一个小型的monorepo：

• 后端: apps/backend --集线器运行时（流式HTTP /mcp)，插件加载器，Prisma/SQLite数据库，管理API。
• 前端: apps/admin --Next.js管理面板，用于管理工具/插件/资源/规则/角色和观察使用情况。

此Hub提供的内容（当前）

• 工具

- 内置工具（以代码实现） - 动态工具（保存在数据库中，通过管理员管理） - 插件工具（外部MCP服务器，通过管理员管理）

• 资源和规则

- 内建 rs4it://registry 总结 - 动态资源/规则（数据库，通过管理员管理） - 插件资源（通过Hub代理）

• 角色和可见性

- 角色+继承（DB） - 按实体可见性过滤

删除了旧功能

这些是有意删除的，不应存在于runtime/UI/docs中：

• 提示
• 技能
• 技能编译器

______________________________________________________________________

配置模型（仅限数据库）

所有运行时配置都存在于 SQLite数据库 （普里斯马）：

• 真相的来源: rs4it.db
• 你是如何管理它的：管理面板→ Hub /api/* （受保护）

从传统JSON一次性迁移（可选）

如果您从使用JSON配置文件的旧设置升级，则可以导入一次。

设置：

• MCP_LEGACY_CONFIG_DIR=/path/to/legacy/config

如果目录包含这些文件中的任何一个，Hub将导入它可以导入的内容 一次，然后设置DB标志 AppSetting(key=migratedFromJson) 为避免重新启动时重新导入：

• roles.json
• dynamic-registry.json
• mcp_plugins.json
• admin-credentials.json

______________________________________________________________________

快速入门（推荐使用Docker Compose）

先决条件

• Docker桌面版（Compose v2）

1） 创建 .env

复制 .env.docker.example → .env 并设置为最小值：

• SESSION_SECRET （必填；16+个字符）
• MCP_ADMIN_API_SECRET （推荐；生产中需要）

2） 开始

docker compose up -d --build

3） 打开

• 管理员： http://localhost:3001/login
• 集线器MCP端点： http://localhost:3000/mcp
• 轮毂徽标： http://localhost:3000/logo

______________________________________________________________________

本地开发（无Docker）

从repo根目录：

npm install
npm run dev:backend:http
npm run dev:admin

• 管理员： http://localhost:3001
• 中心： http://localhost:3000/mcp

注意：Hub的本地Prisma命令位于 apps/backend （它有自己的 package.json).

______________________________________________________________________

光标集成（快速嵌入）

Hub支持 浏览器登录 在 /auth，哪些商店 email + role 在HttpOnly Cookie中。

浏览器登录（推荐）

1. 打开 http://localhost:3000/auth
2. 从下拉列表中选择您的角色
3. 如果选择管理员角色，则必须输入 管理员仪表板密码
4. （可选）输入一次System2030密码以创建存储会话

然后打开 /mcp 在浏览器中；它将使用Cookie（没有身份标头）。

选项A）连接到正在运行的集线器（推荐）

• 启动Hub（Docker或本地HTTP）
• 在Cursor中，添加一个MCP服务器，URL为：

- http://localhost:3000/mcp

如果将集线器部署在域后面，请设置：

• HUB_BASE_URL=https://your-domain.com
• MCP_ALLOWED_HOSTS=your-domain.com

选项B）本地开发工作流程

• 在本地运行Hub(npm run dev:backend:http)
• 将光标指向：

- http://localhost:3000/mcp

其他MCP客户（Claude、Copilot、Codex等）

中心说话 基于HTTP的标准MCP 在 /mcp任何支持MCP远程服务器的产品都可以使用 相同的URL 您给Cursor（用部署替换主机/端口）：

• 当地： http://localhost:3000/mcp
• 已部署： https:///mcp （套 HUB_BASE_URL 和 MCP_ALLOWED_HOSTS 如选项A）

克劳德桌面： 在应用程序的配置中添加MCP服务器条目（名称+URL）。使用上面的Hub URL；如果您的设置需要身份验证，请添加标头（例如。 Authorization 或Hub期望的角色标头）。

VS代码/GitHub副本： 仅当您的VS代码构建为远程HTTP服务器启用了MCP时才连接；指向同一点 /mcp URL。确切的UI和功能标志取决于VS代码版本——像对待任何其他MCP HTTP端点一样对待它。

提示： 如果客户端报告配置或TLS错误，请验证URL、集线器是否可从该计算机访问，以及 MCP_ALLOWED_HOSTS 不使用时包含您的公共主机名 localhost.

______________________________________________________________________

安全要素

• 管理面板身份验证 需要 SESSION_SECRET.
• 中心管理API (/api/*)需要标题 x-admin-secret 匹配 MCP_ADMIN_API_SECRET.

- 生产中(NODE_ENV=production)中心 失败关闭 如果 MCP_ADMIN_API_SECRET 未设置。

• 中心 /api/* 费率有限；System2030会话API编辑令牌。

______________________________________________________________________

文档

看 docs/README.md 对于已维护的文档集：

• docs/admin-auth.md
• docs/architecture.md
• docs/deployment.md
• docs/security.md
• docs/requirements.md

______________________________________________________________________

许可证

无执照的