Nexian MCP Hub

Nexian MCP Hub 是一个多租户 MSP 集成平台，允许每个租户连接第三方系统，并通过单个远程 MCP 服务器公开标准化的、AI 安全的工具。

Monorepo 布局

• apps/web: Next.js 管理员和最终用户应用

• apps/api: 用于身份验证、租户管理、连接器、OAuth 回调和审计 API 的后端 API

• apps/mcp: 带有不记名令牌保护的 HTTP 端点的远程 MCP 服务器

• packages/core: 共享领域类型、安全原语、MCP 模型、验证助手

• packages/connectors: 提供程序适配器和标准化工具实现

• prisma: Postgres 模式和可种子模型

• docker: 本地容器资产

• docs: 架构、部署和安全说明

本地设置

1. 安装 Node.js 22+ 和 pnpm。

2. 将 .env.example 复制到 .env 并填入提供程序凭据。

3. 启动基础设施：

docker compose up -d

4. 安装依赖项：

pnpm install

5. 生成 Prisma 客户端并运行迁移：

pnpm db:generate
pnpm db:migrate

6. 启动堆栈：

pnpm dev

Vercel 部署

将 apps/web Next.js 应用部署为 Vercel 项目。

推荐的 Vercel 设置：

• 根目录：apps/web

• 安装命令：pnpm install

• 构建命令：pnpm build

• 输出目录：留空以进行 Next.js 自动检测

需要在 Vercel 中设置的环境变量：

• NEXT_PUBLIC_API_URL

• NEXT_PUBLIC_MCP_URL

• API_URL

• APP_URL

此仓库将 apps/api 和 apps/mcp 作为独立的 Node 服务保留。对于生产环境，请将它们部署在容器主机上，并通过环境变量将 Vercel 前端指向它们。

Railway 部署

使用 Railway 进行后端拆分：

• Railway 上的 apps/api

• Railway 上的 apps/mcp

• Vercel 上的 apps/web

实际设置指南位于：

• docs/railway-vercel-deploy.md

重要的生产环境关系：

• APP_URL 应为您的 Vercel Web URL

• API_URL 应为您的 Railway API URL

• MCP_URL 应为您的 Railway MCP URL

• HALOPSA_REDIRECT_URI 应指向 Railway API 回调 URL

• Vercel 中的 NEXT_PUBLIC_API_URL 应指向 Railway API URL

• Vercel 中的 NEXT_PUBLIC_MCP_URL 应指向 Railway MCP 端点 URL

• SESSION_SECRET 必须在 API 和 MCP 服务之间保持一致

产品架构

• Web 用户通过平台进行身份验证，并在租户工作区内操作。

• 连接的账户按租户和用户存储，访问令牌和刷新令牌在静态时加密。

• API 负责处理 OAuth 回调、令牌刷新、策略检查、审计日志和连接器生命周期。

• MCP 服务器在每个 HTTP 请求上验证 Authorization: Bearer <token>，并通过租户感知策略路由每个工具调用。

• 提供程序特定的逻辑保留在适配器内部；仅向外部公开标准化工具。

版本 1 连接器范围

• HaloPSA

• Microsoft 365 / SharePoint

• HubSpot (作为 CRM)

• IT Glue (作为文档 / 知识库)

防护措施

• 优先处理读取密集型工具

• 仅对低风险工作流（如草稿工单创建和内部备注）进行安全写入

• v1 版本中不包含破坏性写入

• 所有工具调用都会生成审计事件

下一个实施里程碑

1. 将真实的身份验证和持久化连接到 API 模块骨架中。

2. 添加 Prisma 迁移和数据库客户端引导。

3. 用实时提供程序 SDK 或 REST 集成替换连接器占位符。

4. 添加 OAuth、令牌刷新和 MCP 工具执行的集成测试。