mvp MCP

MCP安全风控

提供方 dopperdev

安全风控 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

企业级MCP通信安全代理,提供认证、授权、请求验证、速率限制和全面审计日志功能。

一句话选型结论

按资料字段整理

mvp MCP 属于安全风控类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

安全代理Python本地部署MCP通信企业安全API网关审计日志

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -c "import secrets; print(secrets.token_urlsafe(32))"

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mvp MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

MCP安全网关

企业级安全代理,用于模型上下文协议(MCP)通信。为MCP服务器提供认证、授权、请求验证、速率限制和全面的审计日志记录功能。

🚀 功能

核心安全功能

  • 🔐 认证与授权

  • 基于JWT的认证

  • 基于用户的身份访问控制列表(ACLs)
  • 细粒度权限(针对每个MCP服务器的读/写/执行权限)
  • 服务账户支持

  • 🛡️ 请求验证与清理

  • SQL注入检测与阻断

  • 防止路径遍历攻击
  • 命令注入检测
  • Base64编码的漏洞利用检测
  • JNDI注入检测(Log4Shell风格)
  • XXE(XML外部实体)防护

  • ⚡ 流量限制

  • 每个用户和MCP服务器的可配置限制

  • 使用Redis的令牌桶算法
  • 优雅降级并提供适当的错误信息

  • 📊 审计日志记录

  • 每个请求都记录了完整的上下文信息

  • PII(个人可识别信息)检测与自动屏蔽
  • 结构化JSON日志记录
  • 可配置的保留策略
  • 异步日志记录以提升性能

  • 📈 实时监控

  • 带有指标可视化的实时仪表板

  • 安全警报和通知
  • 请求跟踪和性能指标
  • 顶级用户和服务器分析

  • 🔍 Prometheus 指标

  • 请求计数器和直方图

  • 请求拦截追踪
  • 自定义指标端点

🏗️ 建筑学```

┌─────────────┐
│ Client │ (Claude Desktop, API clients, etc.)
└──────┬──────┘
│ JWT Token
▼
┌─────────────────────────────────────────┐
│ MCP Security Gateway (Port 8000) │
│ ┌────────────────────────────────────┐ │
│ │ 1. JWT Authentication │ │
│ │ 2. Permission Check │ │
│ │ 3. Rate Limiting │ │
│ │ 4. Security Validation │ │
│ │ • SQL Injection │ │
│ │ • Path Traversal │ │
│ │ • Command Injection │ │
│ │ 5. Audit Logging │ │
│ └────────────────────────────────────┘ │
└──────┬──────────────────────────────────┘
│
▼
┌─────────────┐ ┌─────────────┐
│ MCP Server │ │ MCP Server │
│ (Database) │ │ (Filesystem)│
└─────────────┘ └─────────────┘


## 📋 先决条件

- Docker 及 Docker Compose(推荐)
- Python 3.11+(用于本地开发)
- PostgreSQL 16+(包含在Docker Compose中)
- Redis 7+(包含在Docker Compose中)

## 🚀 快速入门

### 使用 Docker Compose(推荐)

1. **克隆仓库**```bash
git clone
cd mcp-security-gateway
  1. 创建环境文件```bash
    cp .env.example .env

Edit .env and set JWT_SECRET and other variables


3. **启动网关**```bash
docker-compose up -d
  1. 确认它正在运行```bash
    curl http://localhost:8000/health

5. **获取身份验证令牌**```bash
curl -X POST http://localhost:8000/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"admin"}'
  1. 访问仪表板
    在浏览器中打开 http://localhost:8000/dashboard

⚠️ 重要立即在生产环境中更改默认管理员密码!

🔧 配置

环境变量

创建一个 .env 基于文件的 .env.example:```bash

Database

DATABASE_URL=postgresql://mcp_user:mcp_password@postgres:5432/mcp_gateway

Redis

REDIS_URL=redis://redis:6379/0

Security

JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
JWT_ALGORITHM=HS256
JWT_EXPIRATION_HOURS=24

Gateway

GATEWAY_HOST=0.0.0.0
GATEWAY_PORT=8000
LOG_LEVEL=INFO

Rate Limiting

RATE_LIMIT_REQUESTS=100
RATE_LIMIT_PERIOD=3600

Audit

AUDIT_LOG_RETENTION_DAYS=30
PII_DETECTION_ENABLED=true


### YAML 配置

编辑 `config/default.yaml` 对于高级配置:```yaml
# MCP Servers
servers:
- name: "company-database"
upstream_url: "http://localhost:9001"
enabled: true
allowed_tools: ["query", "schema"]
blocked_patterns:
- "DROP"
- "DELETE FROM"

# User Policies
policies:
- user: "data-scientist@company.com"
servers: ["company-database"]
permissions: ["read"]
rate_limit: 100

📚 API 文档

认证

登录```bash

POST /auth/login
Content-Type: application/json

{
"username": "admin",
"password": "admin"
}

Response

{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer",
"expires_in": 86400
}


#### 获取当前用户```bash
GET /auth/me
Authorization: Bearer

# Response
{
"id": 1,
"username": "admin",
"email": "admin@example.com",
"is_active": true,
"is_admin": true
}

MCP 代理

转发MCP请求```bash

POST /mcp/{server_name}
Authorization: Bearer
Content-Type: application/json

{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": "1"
}

Response

{
"jsonrpc": "2.0",
"result": { ... },
"id": "1"
}


### 管理端点

#### 列出MCP服务器```bash
GET /admin/servers
Authorization: Bearer

获取审计日志```bash

GET /admin/audit-logs?limit=100&blocked_only=false
Authorization: Bearer


#### 获取安全警报```bash
GET /admin/security-alerts?limit=50
Authorization: Bearer

获取仪表板指标```bash

GET /admin/metrics
Authorization: Bearer


### OpenAPI 文档

交互式API文档可在以下地址获取:

- Swagger UI:http://localhost:8000/docs

## 🧪 测试

### 运行所有测试```bash
# Using Docker
docker-compose exec gateway pytest

# Local development
pytest

仅运行安全测试```bash

pytest src/tests/test_security.py -v


### 带覆盖运行```bash
pytest --cov=src --cov-report=html

预期测试结果

  • ✅ 50+项安全验证测试
  • ✅ SQL注入检测(10个测试用例)
  • ✅ 路径遍历检测(10个测试用例)
  • ✅ 命令注入检测(5个测试用例)
  • ✅ Base64漏洞检测
  • ✅ JNDI注入检测
  • ✅ 个人身份信息(PII)检测与遮蔽
  • ✅ 性能测试(验证时间 \< 10毫秒)

🔒 安全最佳实践

1. 更改默认凭据```bash

In production, NEVER use default admin/admin

Set strong passwords in environment variables

DEFAULT_ADMIN_PASSWORD=


### 2. 使用强JWT密钥```bash
# Generate a strong secret
python -c &quot;import secrets; print(secrets.token_urlsafe(32))&quot;

# Set in .env
JWT_SECRET=

3. 配置TLS/SSL

在生产环境中,使用带有TLS的反向代理(如nginx、Caddy):```nginx
server {
listen 443 ssl;
server_name gateway.example.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
proxy_pass http://localhost:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}


### 4. 限制网络访问

使用防火墙规则限制访问:```bash
# Only allow specific IPs
iptables -A INPUT -p tcp --dport 8000 -s 10.0.0.0/8 -j ACCEPT
iptables -A INPUT -p tcp --dport 8000 -j DROP

5. 启用审计日志监控

为可疑活动设置警报:

  • 同一用户多次请求被阻止
  • 高严重性安全警报
  • 非典型的访问模式

📊 监控与可观测性

Prometheus 指标

可用指标位于 /metrics 终端点;终点```

Request counters

mcp_gateway_requests_total{method="query", server="db", status="success"} 1234

Request duration

mcp_gateway_request_duration_seconds{method="query", server="db"} 0.015

Blocked requests

mcp_gateway_blocked_requests_total{reason="SQL Injection"} 42


### 仪表盘

访问实时仪表盘,请前往 http://localhost:8000/dashboard

特点:

- 总请求数和被阻止的请求数
- 活跃用户数量
- 平均响应时间
- 每分钟请求数
- 顶级用户和服务器
- 最近的安全警报

## 🚢 部署

### Docker 生产环境部署```bash
# Build production image
docker build -t mcp-gateway:latest .

# Run with production settings
docker run -d \
--name mcp-gateway \
-p 8000:8000 \
--env-file .env.production \
mcp-gateway:latest

Kubernetes 部署```bash

Apply Kubernetes manifests

kubectl apply -f k8s/namespace.yaml
kubectl apply -f k8s/configmap.yaml
kubectl apply -f k8s/secret.yaml
kubectl apply -f k8s/deployment.yaml
kubectl apply -f k8s/service.yaml


## 🐛 故障排除

### 网关无法启动```bash
# Check logs
docker-compose logs gateway

# Check database connection
docker-compose exec postgres pg_isready

# Check Redis connection
docker-compose exec redis redis-cli ping

身份验证失败```bash

Verify JWT secret is set

echo $JWT_SECRET

Check user exists

docker-compose exec postgres psql -U mcp_user -d mcp_gateway \
-c "SELECT username, is_active FROM users;"


### 请求被意外阻止```bash
# Check audit logs
curl -H &quot;Authorization: Bearer $TOKEN&quot; \
http://localhost:8000/admin/audit-logs?blocked_only=true

# Check blocked patterns
docker-compose exec postgres psql -U mcp_user -d mcp_gateway \
-c &quot;SELECT * FROM blocked_patterns WHERE is_active = true;&quot;

🤝 贡献(或:参与贡献)

欢迎贡献!请参阅 CONTRIBUTING.md 了解指南。

📄 许可证

此项目采用MIT许可证授权,请参阅LICENSE文件了解详情。

🙏 致谢

  • 使用……构建 FastAPI
  • 使用Anthropic的 MCP SDK(MCP软件开发工具包)
  • 受企业安全最佳实践的启发

📞 支持

  • 问题:GitHub Issues(GitHub上的问题)
  • 文档: 文档/
  • 安全邮箱:security@example.com

🗺️ 路线图

v0.2.0(计划中)

  • [ ] 基于人工智能的异常检测
  • [ ] 多租户支持
  • [ ] 加密审计日志
  • [ ] 合规报告生成(SOC2,HIPAA)
  • [ ] MCP响应验证
  • [ ] 用于安全事件的Webhook警报

v1.0.0(未来版本)

  • [ ] 高级威胁情报集成
  • [ ] 用于模式检测的机器学习
  • GraphQL API支持
  • [ ] 高级缓存策略
  • [ ] 支持多区域部署

为MCP社区倾心打造

常见问题

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

在客户端按下面的安装命令接入:python -c "import secrets; print(secrets.token_urlsafe(32))"。装完在客户端配置里引用同一个包或端点。

mvp MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

mvp MCP 收费吗?

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

mvp MCP 需要 API Key 吗?

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

mvp MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

mvp MCP 能提供哪些能力?

资料显示能力标签包括 企业安全、Python、Claude、审计日志。具体工具清单以官方文档为准。

mvp MCP 需要什么运行环境?

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

mvp MCP 是本地还是远程?

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

热门专题

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

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