使用说明
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 Brutalismglassmorphism→Glassmorphismbootstrap-light→Bootstrap Lightglassbox-dark→Glassbox Darkfortinet→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
附加文档📚
- Web UI和本地使用: 客户.md
- Docker使用: 医生.md
- 提示示例: PROMPTS.md
- 协议版本差异: 协议_版本.md
