MCP安全演示工具

一个完整的MCP安全演示工具,包含服务器、Web UI客户端、CLI客户端以及Claude Desktop集成资源。

  • by benoitbMTL
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 benoitbMTL/mcp-demo

使用说明

MCP演示🚀

此存储库包含一个完整的MCP安全演示,其中包括:

  • 演示MCP服务器
  • Web UI客户端
  • CLI客户端
  • Claude桌面集成资产
  • shell和PowerShell测试脚本
  • Docker打包用于Web UI+托管MCP服务器控制

仓库布局📁

mcp-demo/
├── apps/
│   ├── cli/
│   │   └── client.py
│   └── web/
│       ├── run_web_ui.py
│       └── webapp/
├── docker/
│   ├── Dockerfile
│   └── docker-entrypoint.sh
├── docs/
│   ├── CLIENT.md
│   ├── DOCKER.md
│   └── PROMPTS.md
├── integrations/
│   └── claude-desktop/
│       ├── claude_desktop_config.json
│       └── mcp_stdio_proxy.py
├── scripts/
│   ├── mcp_tools_list.ps1
│   └── mcp_tools_list.sh
├── server/
│   ├── files/
│   ├── secrets.txt
│   └── server.py
└── requirements.txt

安装🛠️

git clone https://github.com/benoitbMTL/mcp-demo.git
cd mcp-demo
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Makefile快捷方式⚡

您可以使用提供的 Makefile 对于最常见的操作:

make run-server
make run-web
make run-cli
make docker-build
make docker-run

带有覆盖的示例:

make run-server TRANSPORT=sse PROTOCOL_VERSION=2025-03-26
make run-cli TARGET_URL=http://127.0.0.1:7000/sse TRANSPORT=sse PROTOCOL_VERSION=2025-03-26

运行MCP服务器🖥️

python server/server.py --transport streamable-http --host 0.0.0.0 --port 7000 --protocol-version 2025-11-25

服务器选项:

  • --transport: streamable-http 或 sse
  • --protocol-version: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

运行Web UI🌐

python apps/web/run_web_ui.py --theme neo-brutalism

打开:

http://127.0.0.1:7001

主题选项:

  • neo-brutalism → Neo Brutalism
  • glassmorphism → Glassmorphism
  • bootstrap-light → Bootstrap Light
  • glassbox-dark → Glassbox Dark
  • fortinet → Fortinet

默认主题:

  • neo-brutalism

运行CLI客户端💻

python apps/cli/client.py --target-url http://mcp-xperts.labsec.ca/mcp --transport streamable-http --protocol-version 2025-11-25

CLI选项:

  • --transport: streamable-http 或 sse
  • --protocol-version: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

示例:

python apps/cli/client.py --target-url http://127.0.0.1:7000/mcp --transport streamable-http --protocol-version 2025-11-25
python apps/cli/client.py --target-url http://127.0.0.1:7000/sse --transport sse --protocol-version 2025-03-26

附加文档📚