关键词

MCP服务器管理LLM上下文服务服务器部署Web界面CLI工具

使用说明

项目简介

MCP Foundation 是一个用于管理 Model Context Protocol (MCP) 服务器的工具。它本身不是一个MCP服务器，而是一个MCP服务器管理器。你可以使用它来轻松安装、配置、启动和管理各种基于 MCP 的服务器，从而为你的 LLM 应用提供上下文数据和功能扩展。

主要功能点

  • 简化 MCP 服务器安装: 通过简单的命令行或 Web 界面，一键安装和部署 MCP 服务器。
  • 集中化管理: 通过 Web 界面或 CLI 统一管理已安装的 MCP 服务器，包括查看、更新和移除。
  • 灵活配置: 支持通过环境变量自定义 Web 界面和 MCP 客户端的行为。
  • 多方式访问: 提供 Web UI 和 CLI 两种方式进行操作，满足不同用户的需求。
  • 环境隔离: 支持自定义 MCP 客户端的环境变量，方便在 Conda 或 venv 等特定环境中使用。

安装步骤

手动安装 (Manual Install)

  1. 安装 prerequisites: 确保你的机器上已安装以下 prerequisite：

  2. 使用 npm 安装 mcpfoundation: 打开终端，运行以下命令：

    npm install -g mcpfoundation

一键安装 (One-Click Install) - 推荐

如果你安装了 Pinokio，可以直接在 Pinokio 中搜索并安装 MCP Foundation，Pinokio 会自动处理所有依赖和配置。

服务器配置

MCP 客户端配置 (以 Claude 客户端为例)

MCP Foundation 本身不直接作为 MCP 服务器运行，它管理的是其他的 MCP 服务器。你需要使用 MCP Foundation 安装和配置 MCP 服务器后，将 MCP 客户端 (例如 Claude 客户端) 配置为连接到由 MCP Foundation 管理的服务器。

MCP 客户端通常需要一个配置文件来指定要连接的 MCP 服务器。 MCP Foundation 管理的配置文件默认位于：

  • Windows: '%AppData%/Claude/claude_desktop_config.json'
  • Mac: '$HOME/Library/Application Support/Claude/claude_desktop_config.json'

你可以通过修改该配置文件，或者设置 'MCP_CONFIG_PATH' 环境变量来指定配置文件的位置。

配置文件内容 (由 MCP Foundation 自动生成和管理)

MCP Foundation 通过 'add' 命令向配置文件中添加 MCP 服务器的配置信息。配置文件的 JSON 结构大致如下 (以下是一个示例，实际内容会根据你添加的 MCP 服务器而变化):

{
  "mcpServers": {
    "cocktailpeanut.mcp.sqlite": {  // 服务器名称 (name)，由 "github id/name" 转换而来
      "command": "node index.js",    // MCP 服务器的启动命令 (command)
      "args": [],                   // 启动参数 (args)
      "env": {}                     // 环境变量 (env)
    },
    "another.mcp.server": {       // 另一个 MCP 服务器配置
      "command": "python server.py",
      "args": ["--port", "8080"],
      "env": {
        "API_KEY": "your_api_key"
      }
    }
    // ... 更多 MCP 服务器配置
  }
}

重要: 你不需要手动编辑 'claude_desktop_config.json' 文件。 MCP Foundation 提供了 'add', 'rm', 'ls' 等命令来管理配置文件中的 MCP 服务器信息。 你只需要使用 MCP Foundation 的命令来添加和管理 MCP 服务器，MCP 客户端会自动读取配置文件并连接到相应的服务器。

基本使用方法

  1. 启动 Web UI (推荐)

    在终端中运行以下命令启动 Web UI：

    npx mcpfoundation web

    然后访问 'http://localhost:3000' (默认端口) 即可通过 Web 界面管理 MCP 服务器。 Web UI 提供了更友好的操作界面，方便用户进行服务器的添加、删除和查看。

  2. 使用 CLI 命令

    • 添加 MCP 服务器:

      npx mcpfoundation add <github id>/<仓库名>/<js文件名>

      例如，添加 'cocktailpeanut/mcp/sqlite' 仓库的 sqlite MCP 服务器 (假设入口文件是 'index.js')：

      npx mcpfoundation add cocktailpeanut/mcp/sqlite

      对于需要环境变量的 MCP 服务器，可以使用 '--<环境变量名> <值>' 的形式传递环境变量：

      npx mcpfoundation add <github id>/<仓库名>/<js文件名> --GITHUB_PERSONAL_ACCESS_TOKEN <your_token>

    • 列出已安装的 MCP 服务器:

      npx mcpfoundation ls

      该命令会列出所有已安装的 MCP 服务器及其配置信息。

    • 移除 MCP 服务器:

      npx mcpfoundation rm <服务器名称>'

      服务器名称通常是 '<github id>.<仓库名>.<js文件名> (js文件名可选，默认为 index.js)'，例如：

      npx mcpfoundation rm cocktailpeanut.mcp.sqlite

    • 更新 MCP Foundation:

      npx mcpfoundation update

      该命令用于更新 MCP Foundation 自身。

总结: MCP Foundation 作为一个 MCP 服务器管理器，简化了 MCP 服务器的部署和管理流程。通过 Web UI 或 CLI，你可以方便地安装、配置和管理 MCP 服务器，为你的 LLM 应用提供强大的上下文服务支持。

信息

分类

开发者工具

访问项目