使用说明
MCPGate
开源MCP(模型上下文协议)工具网关。通过RBAC、审计日志、会话预算和语义发现将AI代理路由到88多个内置工具服务器。
特性
- 88+内置MCP服务器 --金融、SaaS、DevOps、通信等。每个服务器都通过 MCP协议.
- 凭证适配器 --EnvVar、加密数据库(AES-256-GCM)或复合回退链。带上你自己的适配器。
- 代理身份 --注册代理、插件和委托链。每个代理的作用域权限。
- 会议预算 --通过硬/软执行来限制每次会话的工具调用、成本或持续时间。
- 语义发现 --TF-IDF在1000多种工具中搜索,自动找到合适的服务器。
- 链执行器 --基于DAG的多步工具链,具有可变插值功能。
- 断路器 --对不健康的服务器进行自动故障隔离。
- 审计日志 --每个工具调用都记录了调用者身份、延迟和结果状态。
- 速率限制 --每个代理、每个服务器或全局速率限制。
- 计量 --使用发件箱模式跟踪使用情况,以实现可靠的事件交付。
快速开始
# Clone
git clone https://github.com/raijinlabs/mcpgate.git
cd mcpgate
# Configure
cp .env.example .env
# Edit .env — set DATABASE_URL and any server credentials
# Run migrations
npm run migrate
# Start
npm run dev # http://localhost:4020
建筑
apps/
mcpgate-api/ Fastify API server (:4020)
modules/
mcpgate/
auth/ Credential adapters (EnvVar, Database, Composite)
identity/ Agent, plugin, MCP identity services
session/ Session budgets and quota enforcement
discovery/ Semantic TF-IDF tool search
router/ Tool router, chain executor, rate limiter
registry/ Tool registry, circuit breaker, server health
builtin/ Builtin server registry
servers/ 88+ server integrations + shared utilities
audit/ Audit logger and query interface
metering/ Tool call metering
mcp-client/ MCP transport and session management
schemas/ Request/response schemas
packages/
gateway-core/ Auth, DB, events, policy, quotas
passport/ Passport matching engine
metering/ Usage metering with outbox pattern
observability/ Sentry, tracing, structured logging
migrations/ 9 SQL migrations (Postgres)
内置服务器
97个跨域的服务器集成:
| 类别 | 服务器 |
|---|---|
| 金融/加密货币 | Aave、币安、Coinbase、DeLiLama、Etherscan、Jupiter、Kraken、Lido、1英寸、Phantom、Polymarket、Solscan、Stripe、Uniswap、Zapper |
| 协作 | Slack、团队、Discord、Telegram、Notion、Confluence、Jira、Linear、Asana、Monday、ClickUp、Trello |
| 谷歌套件 | 驱动器、文档、表格、日历、Gmail |
| 开发运维 | GitHub、GitLab、Vercel、Railway |
| 设计 | Figma |
| 自动化 | 扎皮尔 |
| ...以及60多个 |
每个服务器都是一个独立的模块 modules/mcpgate/src/servers/.
凭据管理
MCPGate支持可插拔凭证适配器:
EnvVarAdapter — Read tokens from environment variables (simplest)
DatabaseAdapter — AES-256-GCM encrypted credential store in Postgres
CompositeAdapter — Chain multiple adapters with fallback priority
实施 CredentialAdapter 添加您自己的界面(例如,Vault、AWS Secrets Manager)。
API路线
| 方法 | 路径 | 描述 |
|---|---|---|
| 职位 | /tools/call |
执行工具调用 |
| 得到 | /tools/search |
语义工具发现 |
| 得到 | /servers |
列出已注册的服务器 |
| 职位 | /agents |
注册代理 |
| 职位 | /sessions |
使用预算创建会话 |
| 职位 | /chains |
执行工具链 |
| 得到 | /audit |
查询审核日志 |
| 得到 | /health |
健康检查 |
测试
npm test # Run all tests (vitest)
npm run check:boundary # Verify OSS/cloud boundary
14个测试文件中的93个测试。
自我寄宿
docker build -t mcpgate .
docker run -p 4020:4020 --env-file .env mcpgate
需要Postgres。看 .env.example 用于配置。
许可证
建造于 RaijinLabs.