🧰 带本地凸后端的MCP堵塞检查器的本地设置
本指南解释了如何运行 MCP堵塞检查器完全本地 使用一个 本地Converx后端，没有任何云Converx项目。
您可以通过两种方式运行所有内容：
- 手动设置 （本地Converx+Docker检查器）
- 完整的Docker Compose设置（推荐）
______________________________________________________________________
🏗️ 1.先决条件
在开始之前，请确保您已经：
- Node.js （v18+推荐）
- npm
- Docker 桌面版
- Git （可选）
______________________________________________________________________
⚙️ 2.创建本地凸后端
我们将创建一个运行的后端 完全离线，不需要Converx帐户。
运行：
npm create convex@latest inspector-local出现提示时：
- 选择客户端：
none - 登录：
Start without an account - 继续：
Yes
这将创建一个最小的局部凸项目。
______________________________________________________________________
🚀 3.启动本地凸后端
在项目文件夹中：
cd inspector-local
npx convex dev您应该看到：
Started running a deployment locally at http://127.0.0.1:3210这是你的 本地凸HTTP端点.
保持此终端运行。
______________________________________________________________________
🐳 4.在Docker中运行MCP Jam Inspector（手动方法）
如果要手动运行检查器：
docker run -p 3001:3001 ^
-e CONVEX_HTTP_URL="http://host.docker.internal:3210" ^
mcpjam/mcp-inspector:latest然后打开：
👉 http://localhost:3001
______________________________________________________________________
🔁 5.完整的Docker编写设置（推荐）
此方法运行 凸面+MCP检验员 一起自动。
创建一个名为的文件 docker-compose.yml:
version: "3.8"
services:
convex:
image: convexdev/local
container_name: convex-local
ports:
- "3210:3210"
networks:
- mcp-net
inspector:
image: mcpjam/mcp-inspector:latest
container_name: mcp-inspector
environment:
CONVEX_HTTP_URL: "http://convex:3210"
ports:
- "3001:3001"
depends_on:
- convex
networks:
- mcp-net
networks:
mcp-net:
driver: bridge启动所有服务：
docker compose up在后台运行：
docker compose up -d______________________________________________________________________
🧪 6.测试设置
MCP堵塞检查器UI
👉 http://localhost:3001
凸形仪表板（可选）
👉 http://localhost:6790
*（这可能因具体情况而异 convexdev/local 图像。)*
______________________________________________________________________
💾 7.启用持久存储（可选）
如果您希望Converx数据在容器重启后继续存在，请修改 convex 服务：
volumes:
- convex_data:/root/.convex
volumes:
convex_data:______________________________________________________________________
🆘 8.故障排除
❌ 错误：“CONVERX_HTTP_URL是必需的”
您忘记提供：
-e CONVEX_HTTP_URL=或者您的Compose文件未加载。
______________________________________________________________________
❌ 检查器无法连接到Converx
用途：
- Docker内部：
http://convex:3210 - Docker之外（Windows/macOS）：
http://host.docker.internal:3210
______________________________________________________________________
❌ 端口已在使用中
修改凸形或检查器端口映射：
- "3211:3210"