MCP Gateway 83d8b221

MCPAI代理

提供方 vurgunhajiyev

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

MCP Gateway是一个生产就绪的统一入口点,用于AI代理和下游API,实现了模型上下文协议(MCP)。

一句话选型结论

按资料字段整理

MCP Gateway 83d8b221 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI代理Python本地部署API网关模型上下文协议统一入口生产就绪

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
python3 -m venv .venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Gateway 83d8b221当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方vurgunhajiyev上游标注的维护方 vurgunhajiyev
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.6 KB
来自项目仓库与上游目录的原文,未做删改

MCP Gateway

Production-ready unified entry point for AI Agents and downstream APIs, implementing the Model Context Protocol (MCP).


Quick Start (Local — 5 minutes)

Prerequisites

Tool Minimum Version Check
Python 3.10+ python3 --version
pip 23+ pip3 --version
make any make --version
Docker (optional) 24+ docker --version

> macOS: Install Python via Homebrew: brew install python@3.12
> Windows: Install Python from python.org, then use make via WSL or Git Bash.


Option A — Run with Python directly (recommended for development)```bash

1. Clone / open the project folder

cd mcp-gateway

2. One-command setup (creates virtualenv + installs deps + copies .env)

make setup

3. Start the gateway

make run


The gateway starts at **http://localhost:8080**.

Open the interactive API docs at **http://localhost:8080/docs**.

---

### Option B — Run with Docker Compose (full stack)```bash
# Starts gateway + Redis + Prometheus + Grafana + Jaeger
make docker-up
Service URL
Gateway API http://localhost:8080
API Docs http://localhost:8080/docs
Grafana http://localhost:3000 (admin/admin)
Prometheus http://localhost:9091
Jaeger (traces) http://localhost:16686

Manual Setup (step by step)

If you prefer not to use make:```bash

1. Create virtual environment

python3 -m venv .venv
source .venv/bin/activate # macOS/Linux

.venv\Scripts\activate # Windows

2. Install dependencies

pip install -e ".[dev]"

3. Copy environment config

cp .env.example .env

4. Create log directory

mkdir -p logs

5. Start the gateway

uvicorn src.main:app --host 0.0.0.0 --port 8080 --reload


---

## Configuration

All configuration is in the `.env` file (copied from `.env.example` during setup).

### Key settings```dotenv
# Auth — who can call the gateway
GATEWAY_AUTH_ENABLED=true
GATEWAY_API_KEYS_FILE=config/api_keys.json      # your API keys

# Upstream APIs — what the gateway proxies to
GATEWAY_UPSTREAM_CONFIG_FILE=config/upstreams.json

# Rate limiting
GATEWAY_RATE_LIMIT__DEFAULT_RPM=60             # requests per minute per identity
GATEWAY_RATE_LIMIT__BURST_ALLOWANCE=10

# Debug / dev mode
GATEWAY_DEBUG=true
GATEWAY_ENVIRONMENT=development

Add your own upstream API

Edit config/upstreams.json:```json
[
{
"name": "my-api",
"url": "https://api.example.com",
"description": "My downstream API",
"upstream_token": "your-bearer-token-here",
"timeout_seconds": 30,
"tags": ["internal"]
}
]


### Add an API key

Edit `config/api_keys.json`:```json
[
  {
    "key": "my-secret-key-001",
    "owner": "your-name",
    "allowed_upstreams": [],
    "rate_limit_rpm": -1,
    "scopes": ["read", "write"]
  }
]

Try It Out

Once the gateway is running, open a new terminal and try these:

Health check (no auth required)```bash

curl http://localhost:8080/health


### List configured upstreams```bash
curl http://localhost:8080/upstreams \
  -H "X-Api-Key: dev-key-alice-001"

Send an MCP initialize request```bash

curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-H "X-Api-Key: dev-key-alice-001" \
-d '{
"version": "1.0",
"request": {
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"clientInfo": {"name": "my-agent", "version": "1.0"}
}
}
}'


### Register an AI agent (get a session token)```bash
curl -X POST http://localhost:8080/agents/register \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: dev-key-alice-001" \
  -d '{
    "agent_name": "my-llm-agent",
    "agent_version": "1.0.0",
    "requested_upstreams": [],
    "requested_scopes": ["read", "write"]
  }'

Use agent token to call MCP```bash

Replace <token> with the token from the register response

curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-H "X-Agent-Token: <token>" \
-d '{
"request": {
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}
}'


### Proxy directly to an upstream```bash
curl -X POST http://localhost:8080/mcp/notion \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;X-Api-Key: dev-key-alice-001&quot; \
  -d &#x27;{&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;id&quot;:1,&quot;method&quot;:&quot;tools/list&quot;}&#x27;

Common Commands```bash

make run # Start gateway (http://localhost:8080)
make run-reload # Start with hot-reload (auto-restarts on code change)
make test # Run all tests
make test-unit # Run unit tests only
make lint # Lint code with ruff
make format # Auto-format code
make typecheck # Type check with mypy
make docker-up # Start full stack (gateway + Redis + monitoring)
make docker-down # Stop Docker stack
make clean # Remove virtualenv and caches


---

## Project Structure```
mcp-gateway/
├── src/
│   ├── main.py                    ← Entry point
│   ├── core/
│   │   ├── app.py                 ← App factory + middleware wiring
│   │   ├── config.py              ← All configuration (env + JSON)
│   │   └── state.py               ← Shared HTTP pool + rate buckets
│   ├── protocol/
│   │   ├── mcp_types.py           ← MCP message types
│   │   └── validator.py           ← Request validation pipeline
│   ├── routing/
│   │   ├── mcp_router.py          ← MCP method handling
│   │   └── proxy.py               ← Reverse proxy with retries
│   ├── security/
│   │   ├── auth.py                ← API Key + OAuth JWT + Agent auth
│   │   └── agent_registry.py      ← Agent session management
│   ├── middleware/
│   │   ├── rate_limiter.py        ← Token-bucket rate limiting
│   │   ├── logging_mw.py          ← Structured JSON access logs
│   │   └── circuit_breaker.py     ← Per-upstream circuit breaker
│   └── observability/
│       ├── telemetry.py           ← OpenTelemetry + Prometheus
│       └── health.py              ← /health, /readyz, /metrics
├── config/
│   ├── api_keys.json              ← API credentials
│   └── upstreams.json             ← Downstream API definitions
├── tests/
│   ├── unit/                      ← Fast, isolated tests
│   └── integration/               ← Full stack tests
├── deploy/k8s/                    ← Kubernetes manifests
├── monitoring/                    ← Prometheus + Grafana configs
├── Dockerfile                     ← Multi-stage production image
├── docker-compose.yml             ← Local dev stack
├── Makefile                       ← Developer commands
└── .env.example                   ← Config template

Authentication

The gateway supports three auth methods, all tried in order on each request:

Method Header Example
API Key X-Api-Key X-Api-Key: dev-key-alice-001
Agent Token X-Agent-Token X-Agent-Token:
OAuth Bearer Authorization Authorization: Bearer

Public paths (no auth needed): /health, /readyz, /metrics, /docs


Key Endpoints

Endpoint Method Auth Description
/health GET None Liveness probe
/readyz GET None Readiness + upstream health
/metrics GET None Prometheus metrics
/docs GET None Swagger UI
/mcp POST Required MCP protocol endpoint
/mcp/{upstream} POST Required Direct upstream proxy
/agents/register POST Required Register AI agent
/agents/sessions GET Required List active sessions
/upstreams GET Required List configured upstreams
/config/info GET Required Gateway configuration info

Troubleshooting

ModuleNotFoundError: No module named &#x27;src&#x27;
→ Make sure you're in the mcp-gateway/ directory, not a subdirectory.
→ Run pip install -e &quot;.[dev]&quot; from the project root.

401 Unauthorized
→ Add header -H &quot;X-Api-Key: dev-key-alice-001&quot; to your requests.
→ Check config/api_keys.json contains the key you're using.

Address already in use (port 8080)
→ Change the port: uvicorn src.main:app --port 8090
→ Or update GATEWAY_PORT=8090 in your .env file.

429 Too Many Requests
→ You've hit the rate limit. Wait a minute or increase GATEWAY_RATE_LIMIT__DEFAULT_RPM in .env.


Documentation

Full architecture document: docs/ARCHITECTURE.md

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
MCP Gateway 83d8b221 怎么安装?

在客户端按下面的安装命令接入:python3 -m venv .venv。装完在客户端配置里引用同一个包或端点。

MCP Gateway 83d8b221 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Gateway 83d8b221 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Gateway 83d8b221 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

MCP Gateway 83d8b221 能提供哪些能力?

资料显示能力标签包括 AI代理、生产就绪、Python、API网关。具体工具清单以官方文档为准。

MCP Gateway 83d8b221 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

MCP Gateway 83d8b221 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。