前置要求
在开始之前，请确保您拥有：- 已安装 Docker 和 Docker Compose
- Git 用于克隆仓库
- 对 MCP（模型上下文协议）的基本理解
步骤 1：安装
克隆仓库
克隆仓库
从 GitHub 克隆 MetaMCP 并导航到项目目录：
配置环境
配置环境
复制示例环境文件并根据需要进行自定义：
如果您在
.env 文件中修改了 APP_URL，请确保仅从该 URL 访问 MetaMCP，因为 CORS 策略强制执行。在生产环境中，请确保修改 POSTGRES_PASSWORD 和 BETTER_AUTH_SECRET。同时使用 HTTPS。生成密钥的典型方法是
openssl rand -hex 32 | base64使用 Docker Compose 启动
使用 Docker Compose 启动
使用 Docker Compose 启动 MetaMCP：这将启动：
- MetaMCP 全栈 Docker 镜像
- PostgreSQL 数据库
首次启动可能需要几分钟，因为需要拉取和下载 Docker 镜像。
步骤 2：访问 MetaMCP
容器运行后：- 打开浏览器并访问
http://localhost:12008（或您配置的APP_URL） - 创建账户或登录
- 探索仪表板 - 您将看到 MCP 服务器、命名空间和端点的部分
- （可选）禁用注册 您可能只允许您和您的团队访问 MetaMCP，因此一旦设置账户，您可以在设置页面禁用新用户注册。
步骤 3：配置您的第一个 MCP 服务器
步骤 3.1：添加 MCP 服务器
步骤 3.1：添加 MCP 服务器
- 导航到侧边栏中的 MCP 服务器（或您可以从探索和搜索页面快速添加一个）
- 点击 “添加服务器” 按钮（右上角）
- 在打开的对话框中，填写服务器配置：
- 名称：
hackernews-server（必须是 URL 兼容的：仅限字母、数字、下划线、连字符） - 描述：
用于获取故事和评论的 HackerNews MCP 服务器 - 类型：从下拉菜单中选择
STDIO
- 命令：
uvx - 参数：
mcp-hn（空格分隔的参数） - 环境变量：留空（格式：
KEY=value，每行一个）
- 选择 “仅限我自己（私有）” 或 “所有人（公共）”
- 私有服务器仅对您可访问
- 公共服务器对所有用户可访问
- 点击 “创建服务器”
- 您应该看到成功消息：“MCP 服务器已创建”
创建服务器后，您可以点击它查看详细信息、测试连接并查看可用工具。
步骤 3.2：创建命名空间
步骤 3.2：创建命名空间
为什么需要命名空间？ 命名空间将多个 MCP 服务器分组在一起，并为外部访问提供统一端点。
- 转到侧边栏中的 命名空间
- 点击 “创建命名空间” 按钮（右上角）
- 填写命名空间表单：
- 名称：
news-information（服务器组的描述性名称） - 描述：
包含新闻和信息检索工具的命名空间
- 选择 “仅限我自己（私有）” 或 “所有人（公共）”
- 您将看到带有复选框的可用 MCP 服务器列表
- 勾选您的 “hackernews-server” 旁边的复选框
- 您可以为一个命名空间选择多个服务器
- 每个服务器显示其类型（STDIO、SSE 等）和描述
- 点击 “创建命名空间”
- 成功消息：“命名空间已创建”
您稍后可以通过编辑命名空间来添加或删除服务器。
步骤 4：管理命名空间中的工具
审查并禁用未使用的工具
审查并禁用未使用的工具
为什么要管理工具？ 每个 MCP 服务器可能暴露许多工具，但您可能只想通过端点提供某些工具。
- 转到侧边栏中的 命名空间
- 点击您的 “news-information” 命名空间查看详细信息
- 您将看到三个主要部分：
- 检查命名空间是否可以连接到其 MCP 服务器
- 绿色状态表示所有服务器都可访问
- 如果需要，点击 “连接” 建立连接
- 查看分配给此命名空间的所有服务器
- 查看服务器状态（活动/非活动/错误）
- 监控服务器健康状态和配置
- 查看来自服务器的所有可用工具
- 每个工具显示：
- 工具名称（例如，
get_top_stories、get_story） - 源服务器（哪个服务器提供此工具）
- 描述和输入模式
- 状态（启用/禁用）
- 工具名称（例如，
- 禁用不需要的工具：
- 取消勾选您不想通过端点暴露的工具
- 例如，您可能保留
get_top_stories但禁用get_user_info - 这有助于保持端点专注和安全
- 如果需要，刷新工具以从服务器获取最新工具
只有启用的工具在外部应用程序使用您的端点时才可用。
步骤 5：创建端点
创建您的公共端点
创建您的公共端点
什么是端点？ 端点通过其他应用程序可以使用的 HTTP API 为您的命名空间提供外部访问。
- 导航到侧边栏中的 端点
- 点击 “创建端点” 按钮（右上角）
- 配置您的端点：
- 名称：
news-endpoint（URL 兼容名称 - 这变成/metamcp/news-endpoint） - 描述（可选）：
新闻和信息工具的公共端点
- 选择 “仅限我自己（私有）” 或 “所有人（公共）”
- 点击 “选择命名空间” 下拉菜单
- 选择您的 “news-information” 命名空间
- 您将在下拉菜单中看到命名空间名称和描述
- 启用 API 密钥身份验证：切换开启（推荐）
- 这需要 API 密钥进行端点访问
- 使用查询参数身份验证：切换开启/关闭
- 开启时：允许 URL 中的
?api_key=xxx - 关闭时：仅在
Authorization: Bearer xxx标头中接受 API 密钥
- 开启时：允许 URL 中的
- “自动为此端点创建 MCP 服务器”：勾选此框
- 这会创建一个用于检查的可流式 HTTP MCP 服务器配置
- 点击 “创建端点”
- 成功消息：“端点已创建”
- SSE：
http://localhost:12008/metamcp/news-endpoint/sse - 可流式 HTTP：
http://localhost:12008/metamcp/news-endpoint/mcp - OpenAPI：
http://localhost:12008/metamcp/news-endpoint/api - 模式：
http://localhost:12008/metamcp/news-endpoint/api/openapi.json
步骤 6：生成 API 密钥
创建 API 密钥
创建 API 密钥
- 转到侧边栏中的 API 密钥
- 点击 “生成密钥” 按钮
- 填写 API 密钥表单：
- 描述：
我的第一个 MetaMCP API 密钥，用于新闻端点 - 作用域：
- 私有：只有您可以使用此密钥
- 公共：所有用户都可以使用此密钥
- 点击 “生成密钥”
- 重要：复制并安全保存密钥 - 它以
sk_mt_开头 - 此密钥将用于对端点请求进行身份验证
API 密钥只显示一次。请确保立即复制它。
步骤 7：管理您的配置
管理 MCP 服务器
管理 MCP 服务器
查看服务器详细信息：
- 点击 MCP 服务器列表中的任何服务器
- 查看连接状态、可用工具和配置
- 测试服务器连接并检查工具
- 使用每个服务器旁边的操作菜单（⋯）
- 修改配置、添加环境变量
- 更新命令和参数
- 活动：服务器正在运行且可用
- 非活动：服务器已配置但未运行
- 错误：服务器有连接问题
管理命名空间
管理命名空间
查看命名空间详细信息：
- 点击任何命名空间查看其服务器和工具
- 监控命名空间中哪些服务器处于活动状态
- 查看来自所有服务器的聚合工具
- 从现有命名空间添加或删除服务器
- 更新名称和描述
- 更改所有权设置
- 查看命名空间中所有服务器可用的工具
- 启用/禁用特定工具
- 查看工具模式和文档
管理端点
管理端点
端点 URL：
每个端点提供多种访问方法：
- SSE：用于实时通信的服务器发送事件
- 可流式 HTTP：基于 HTTP 的 MCP 通信
- OpenAPI：带有 OpenAPI 文档的 REST API
- 模式：用于集成的 OpenAPI JSON 模式
- 使用操作菜单（⋯）复制特定 URL
- 复制带有或不带有嵌入 API 密钥的 URL
- 为不同集成使用不同格式
- 更改端点映射到的命名空间
- 更新身份验证设置
- 修改访问权限
下一步
添加更多服务器
了解如何配置不同类型的 MCP 服务器（STDIO、HTTP 等）
配置中间件
应用中间件来过滤工具和转换请求/响应
连接到 Cursor
配置 Cursor IDE 使用您的 MetaMCP 端点
连接到 Claude Desktop
使用 mcp-proxy 设置 Claude Desktop 与 MetaMCP
故障排除
常见问题
常见问题
CORS 错误：确保您从
APP_URL 中指定的 URL 访问 MetaMCP。数据库连接：使用 docker ps 检查 PostgreSQL 容器是否正在运行。内存问题：MetaMCP 需要至少 2GB RAM 以获得最佳性能。服务器连接失败：在服务器详细信息页面检查 MCP 服务器日志。身份验证问题：验证 API 密钥是否处于活动状态且格式正确。需要帮助？
需要帮助？
- 浏览 GitHub Issues
- 加入我们的 Discord 社区