MCP Sentinel

MCP 基础设施套件

Model Context Protocol 生态系统缺失的基础设施层。

flowchart LR
    Shared["@oaslananka/shared"]
    Forge["@oaslananka/forge"]
    Sentinel["@oaslananka/sentinel"]
    Atlas["@oaslananka/atlas"]
    Composer["@oaslananka/composer"]
    Bridge["@oaslananka/bridge"]
    Observatory["@oaslananka/observatory"]
    Lab["@oaslananka/lab"]

    Shared --> Forge
    Shared --> Sentinel
    Shared --> Atlas
    Shared --> Composer
    Shared --> Bridge
    Shared --> Observatory
    Shared --> Lab

    Clients["IDE / Agent / SDK clients"] --> Sentinel
    Clients --> Composer
    Composer --> Backends["Backend MCP servers"]
    Sentinel --> Backends
    Forge --> Composer
    Forge --> Sentinel
    Atlas --> Clients
    Observatory --> Sentinel
    Observatory --> Forge
    Lab --> Composer

为什么选择 mcp-suite？

大多数 MCP 项目止步于服务边界。mcp-suite 专注于其周边更具挑战性的生产环境层面：传输兼容性、信任边界、编排、发现、可观测性和运维工作流。因此，当你不再满足于单一本地演示，开始在团队、CI 或内部平台中运行 MCP 时，它就能派上用场。

该套件专为受控的 GitHub 托管发布自动化而构建，每个可发布的软件包都已准备好通过公开 npm 在 @oaslananka 作用域下发布。这个单体仓库采用严格的 TypeScript、Turborepo、pnpm 和基于 release-please manifest 的管理方式。

与一次性的 MCP 工具不同，这里的软件包经过设计，可以组合使用：shared 定义协议和运行时基准，sentinel 与 composer 管控流量，forge 编排工作，atlas 编目能力，bridge 生成服务，observatory 完成反馈闭环，而 lab 则为贡献者提供桌面工作台。

软件包

软件包	功能	文档
@oaslananka/shared	MCP 协议、传输、身份验证、重试、遥测和测试原语	Shared 文档
@oaslananka/forge	用于编排 MCP 工具和外部步骤的流水线引擎	Forge 文档
@oaslananka/sentinel	零信任安全代理，提供审计、审批和 PII 控制	Sentinel 文档
@oaslananka/atlas	用于发现 MCP 服务的注册表 API 和目录界面	Atlas 文档
@oaslananka/composer	聚合多个后端 MCP 服务的代理	Composer 文档
@oaslananka/bridge	基于 OpenAPI 和 Schema 优先的 MCP 服务生成	Bridge 文档
@oaslananka/observatory	指标、追踪、异常检测、告警和仪表板界面	Observatory 文档
@oaslananka/lab	用于连接和调试 MCP 服务的 Electron 桌面工作台	Lab 文档

MCP Lab 截图

本地 Playground

可复现的演示流程是在本地 Playground 中使用预置的 Atlas 和 Observatory 数据：

pnpm install --frozen-lockfile
pnpm build
pnpm run playground:seed
pnpm run playground:atlas

然后在另一个终端中启动 Observatory：

pnpm run playground:observatory

在 http://localhost:4003 打开 Atlas，在 http://localhost:4006 打开 Observatory，并使用 pnpm --filter @oaslananka/lab dev 启动 Lab。完整步骤请参阅本地 Playground 指南。

快速开始

pnpm install --frozen-lockfile
pnpm build

# Seed and run Atlas
pnpm --filter @oaslananka/atlas exec node dist/cli.js seed --db ./data/atlas.sqlite
pnpm --filter @oaslananka/atlas exec node dist/cli.js serve --db ./data/atlas.sqlite --port 4003

# In another terminal, run Observatory
pnpm --filter @oaslananka/observatory exec node dist/cli.js serve --db ./data/observatory.sqlite --port 4006

服务启动后：

• Atlas UI：http://localhost:4003
• Atlas 健康检查：http://localhost:4003/health
• Observatory UI：http://localhost:4006
• Observatory 健康检查：http://localhost:4006/health

架构

shared 提供协议基线、日志记录器工厂、传输层、遥测助手和测试夹具，供其他所有组件使用。面向 MCP 客户端的流量通常由 sentinel 包装，以实施策略并进行审计，然后通过 composer 汇总，或由 forge 编排。atlas 和 observatory 是以 HTTP 为先的运维界面，而 lab 是面向开发者的桌面入口。

在 1.0 过渡期间，该套件目前默认使用 MCP 协议版本 2025-11-25，同时保留了对 2025-11-05 握手的兼容性辅助工具。

架构决策记录在 ADR 索引中。

开发

make install
pnpm run format:check
make lint
make typecheck
make test
pnpm run security
make test-coverage
make knip
pnpm run release:dry-run

更多设置和工作流指南请参阅 docs/development.md、docs/testing.md、docs/security.md、docs/release.md、docs/api-reference.md 中生成的 API 参考，以及 docs/guide 下的指南文档。

发布策略

• release-please 清单模式负责版本升级、变更日志、标签和 GitHub 发布。
• GitHub Actions 从干净的检出状态构建 npm 软件包 tarball、机器可读的发布清单、SBOM、校验和及证明。
• 生产环境的 npm 发布流程独立运行并受环境保护；在完成校验和、证明、软件包内容及干净安装验证后，使用 npm trusted publishing/OIDC。
• 部分 npm 发布可续传：跳过相同的不可变版本，按依赖顺序发布缺失版本，遇到完整性冲突时则安全失败。
• 仅涉及文档、内部内容或 CI 的更改不会发布到 npm，也不会更新注册表元数据。

贡献

欢迎贡献。请先阅读 CONTRIBUTING.md，面向用户的更改请使用 Conventional Commits，并在添加验证步骤时确保与 GitHub Actions 保持一致。 有关问题分类、支持、过期处理、标签和维护者响应目标，请参阅 docs/governance.md。

路线图

• @oaslananka/gateway：以 HTTP 为先的多租户 MCP 网关
• @oaslananka/sdk：从 Python 开始的跨语言 SDK 接口
• 基于 React Flow 构建的 Forge 可视化编辑器
• Atlas 在多个注册表实例之间的联邦
• Observatory 导出到 Grafana 和 OTel collector 管道
• Sentinel 与 OPA 的策略集成

许可证

Apache 2.0 — © 2025-2026 oaslananka