约 5 分钟
推荐Docker Compose 使用仓库内置的 Compose 配置运行完整的自托管服务。 约 10 分钟
ASP.NET Core / NuGet 把 MCP 运行时和可选的管理界面嵌入现有 ASP.NET Core 应用。 安装完成后
连接 MCP 客户端 签发权限受限的密钥,并连接 Claude Desktop、Cursor 或其他 Streamable HTTP 客户端。 Docker Compose
- 创建环境配置文件
复制仓库中的示例文件,让配置保持明确并便于审查。
cp .env.example .env - 替换签名密钥
为 HMAC_KEY 和 JWT_KEY 分别设置不同且至少 32 字节的唯一密钥。
.env.example中的值只是占位示例,请勿原样部署到生产环境。 - 启动服务
启动默认的单实例服务栈。
docker compose up -d - 打开管理界面
应用默认监听 8080 端口。
本地环境可以打开
http://localhost:8080,然后完成首个管理员设置。
签发第一把 MCP 密钥
- 打开 Runtime → MCP Keys
MCP 密钥是客户端身份识别和授权检查的边界。
- 选择数据库和工具权限范围
把密钥绑定到一个 Database Management 条目,并且只开放客户端实际需要的工具。
- 复制明文密钥
密钥签发后会在生命周期对话框中显示一次,请复制并保存到客户端的安全凭据存储中。
- 使用自动生成的客户端配置
也可以通过 X-MCP-Server-Key 请求头把密钥发送到 Streamable HTTP 端点。
默认 MCP 端点是 /mcp。如果客户端不在本机,请把 MCP_PUBLIC_ENDPOINT 设置为外部可以访问的 HTTP 或 HTTPS 绝对 URL,并包含 /mcp 路径。