Skip to main content
Glama
navadiashrey

external-ai-ecosystem-gateway

by navadiashrey

External AI Ecosystem Gateway

一个面向安全的 Python 网关,向兼容 MCP 的助手客户端暴露按权限范围限定的工具,同时中介对外部系统(如 Slack)的访问。它演示了租户隔离、委派授权、敏感写入的人工确认、幂等执行、签名 Webhook 验证、支持撤销的授权存储,以及哈希链审计追踪。

这是一个作品集/参考实现,不是生产级身份提供方。部署前,必须将基于请求头的开发认证适配器替换为 docs/security.md 中描述的 OIDC 验证中间件。

架构

Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

Related MCP server: MCP Tool Manager

快速开始

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

列出工具:

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

使用 pytest 运行测试套件。当未配置 Slack 令牌时,连接器以安全沙箱模式运行,并返回其将要发出的请求。

安全属性

  • 每个主体和幂等键都按租户命名空间隔离。

  • 工具策略将最小权限角色与委派作用域相结合。

  • 敏感写入需要绑定到主体、租户、工具和参数的短期令牌。

  • Webhook 签名使用恒定时间比较,并拒绝过期请求。

  • 审计记录形成 SHA-256 链,因此删除或篡改可被检测。

  • OAuth 授权支持撤销,且绝不通过工具结果暴露刷新令牌。

有关生产加固清单和威胁模型,请参阅 docs/security.md。

许可证

MIT

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to securely discover, invoke, and manage tools through a hardened MCP endpoint with protections like injection detection, circuit breakers, retry backoff, response caching, context-window limiting, and state snapshots.
    9 npm
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to securely call enterprise MCP tools with tenant-scoped RBAC, human approvals, audit logging, and multi-tool workflows across customer, order, document, and ticket data.
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables existing apps to expose their users and data to external AI agents via MCP with OAuth 2.1 authentication and scoped tools.
    27 npm
    MIT