使用说明

项目简介

MetaMCP App 是一个开源的自托管应用程序，用于管理多个 Model Context Protocol (MCP) 服务器。它提供图形用户界面 (GUI) 来简化 MCP 服务器的配置和管理，支持管理资源、工具和 Prompt 模板，并充当 MCP 客户端的代理入口，实现多工作区管理和上下文隔离。

主要功能点

图形化界面管理 MCP 服务器：提供友好的 Web 界面，方便用户添加、配置和管理多个 MCP 服务器，无需复杂的命令行操作。
支持资源、工具和 Prompt 模板管理：允许用户在 MetaMCP App 中集中管理和配置 MCP 服务器的各项核心元素，例如工具 (Tools)、资源 (Resources) 和 Prompt 模板 (Prompts)。
多工作区支持：通过工作区 (Profile) 功能，用户可以轻松切换不同的 MCP 服务器配置环境，隔离不同任务或项目的上下文，避免相互干扰。
MCP 客户端代理入口：MetaMCP App 可以作为 MCP 客户端的代理服务器，客户端只需连接到 MetaMCP App，即可通过它访问和管理后端配置的多个 MCP 服务器。
自托管部署，数据私有安全：用户可以将 MetaMCP App 部署在自己的服务器上，完全掌控数据和配置，保障数据安全和隐私。

安装步骤

克隆仓库：在你的本地机器上克隆 MetaMCP App 的 GitHub 仓库：

git clone https://github.com/metatool-ai/metatool-app.git

进入目录：进入克隆下来的仓库目录：
```
cd metatool-app
```

复制环境变量配置文件：复制 'example.env' 文件并重命名为 '.env'，然后根据你的实际情况修改 '.env' 文件中的配置，例如数据库连接信息等。

cp example.env .env
# 编辑 .env 文件，配置数据库等信息

使用 Docker Compose 启动应用：确保你已经安装了 Docker 和 Docker Compose，然后执行以下命令启动 MetaMCP App：
```
docker compose up --build -d
```
访问应用：等待 Docker 镜像构建和容器启动完成后，在浏览器中访问 'http://localhost:12005'，即可打开 MetaMCP App 的 Web 界面。

服务器配置 (MCP 客户端)

MCP 客户端需要配置连接到 MetaMCP 的命令。MetaMCP 本身作为一个 MCP 服务器代理，它需要通过 'mcp-server-metamcp' 这个 npm 包来运行。以下是一个 Claude Desktop 客户端的配置示例：

{
  "mcpServers": {
    "MetaMCP": {
      "command": "npx",
      "args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
      "env": {
        "METAMCP_API_KEY": "<your api key>",
        "METAMCP_API_BASE_URL": "http://localhost:12005"
      }
    }
  }
}

配置参数说明：

'server name': 'MetaMCP' (MCP 客户端中显示的服务器名称，可以自定义)
'command': 'npx' (Node.js 包执行命令，确保你的环境中已安装 Node.js 和 npm)
'args': '["-y", "@metamcp/mcp-server-metamcp@latest"]' (运行 '@metamcp/mcp-server-metamcp' npm 包的最新版本，'-y' 参数表示自动确认安装，跳过安装确认提示)
'env': 环境变量配置
- 'METAMCP_API_KEY': '<your api key>' (API 密钥，需要在 MetaMCP App 的 Web 界面 "API Keys" 页面生成并获取)
- 'METAMCP_API_BASE_URL': 'http://localhost:12005' (MetaMCP App 的访问地址，如果你的 MetaMCP App 部署在不同的地址或端口，请相应修改)

基本使用方法

访问 MetaMCP App Web 界面：打开浏览器，访问 'http://localhost:12005'，开始使用 MetaMCP App。
创建项目和工作区：在 MetaMCP App 中，首先创建项目 (Project)，然后在项目中创建工作区 (Profile)。工作区用于隔离不同的 MCP 服务器配置环境。
配置和管理 MCP 服务器：在选定的工作区中，你可以添加和管理 MCP 服务器。MetaMCP App 支持添加预定义的 MCP 服务器，也允许用户自定义 MCP 服务器代码。
生成 API Key：在 MetaMCP App 的 "API Keys" 页面，为你的项目生成 API Key。这个 API Key 将用于 MCP 客户端连接 MetaMCP App 时的身份验证。
配置 MCP 客户端：根据上述 "服务器配置 (MCP 客户端)" 中的示例，配置你的 MCP 客户端（例如 Claude Desktop, Cursor 等），将 'command'、'args' 和 'env' 参数设置为连接到 MetaMCP App。确保将 '<your api key>' 替换为你生成的 API Key，'http://localhost:12005' 替换为你的 MetaMCP App 访问地址。
连接和使用：配置完成后，MCP 客户端即可通过 MetaMCP App 代理服务器连接到后端的 MCP 服务器，开始体验工具调用、资源访问等 MCP 功能。

关键词