使用说明

项目简介

MCP Server Builder (mcp-builder) 是一个独特的MCP服务器,它的主要功能并非直接提供资源或工具给LLM客户端,而是作为一个 MCP服务器的安装和管理工具。 它可以帮助用户更方便地安装和配置各种类型的MCP服务器(如Python, Node.js等),并将其集成到支持MCP协议的客户端应用中,例如 Claude Desktop。

简单来说,你可以把它看作是 MCP服务器的“脚手架”或“插件管理器”,它自身作为一个MCP服务器运行,但其核心价值在于帮助你快速部署和使用其他的MCP服务器。

主要功能点

  • MCP服务器安装: 支持从PyPI (Python包仓库) 或 npm (Node.js包仓库) 安装MCP服务器。
  • 本地目录安装: 支持从本地代码仓库安装MCP服务器。
  • 配置管理: 自动配置Claude Desktop等客户端,注册并启用已安装的MCP服务器。
  • 跨平台: 基于Python开发,理论上支持Windows, macOS, Linux等多种操作系统。

安装步骤

  1. 安装 Python: 确保你的电脑上安装了 Python 3.10 或更高版本。
  2. 安装 mcp-builder: 打开终端或命令提示符,运行以下命令安装 mcp-builder:
    pip install mcp-builder

服务器配置

MCP客户端(例如 Claude Desktop)需要配置 'mcp-builder' 服务器的启动命令才能连接并使用它。 以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例,你需要将 'mcp-builder' 添加到 'mcpServers' 字段中。

{
  "mcpServers": {
    "mcp-builder": {  // 服务器名称,可以自定义
      "command": "python", // 启动命令,这里使用 python
      "args": [          // 命令参数
        "-m",
        "mcp_builder.server" // 指定运行 mcp_builder.server 模块
      ]
    }
  }
}

配置参数说明:

  • '"mcp-builder"': 这是你为该服务器定义的名称,客户端会使用这个名称来引用它。你可以自定义,例如 "my-mcp-builder"。
  • '"command": "python"': 指定运行服务器的命令是 'python'。
  • '"args": ["-m", "mcp_builder.server"]': 指定传递给 'python' 命令的参数,'-m mcp_builder.server' 表示以模块方式运行 'mcp_builder.server'。

Claude Desktop 配置文件路径:

  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Linux: '~/.config/Claude/claude_desktop_config.json'

请根据你的操作系统,找到 'claude_desktop_config.json' 文件,并按照上面的 JSON 格式添加 'mcp-builder' 的配置。 如果文件不存在,可能需要手动创建 'claude_desktop_config.json' 文件,并确保其内容是有效的 JSON 格式。

基本使用方法

'mcp-builder' 作为一个 MCP 服务器运行后,你可以通过支持 MCP 协议的客户端(如 Claude Desktop)与其交互。 'mcp-builder' 主要提供了以下两个工具 (Tools):

  1. 'install_repo_mcp_server': 用于安装来自 PyPI 或 npm 仓库的 MCP 服务器。

    • 你可以在 Claude 中使用类似这样的指令来调用这个工具:

      install playwright-mcp from npm install my-python-mcp-server from pypi

  2. 'install_local_mcp_server': 用于安装本地代码仓库中的 MCP 服务器。

    • 你需要在 Claude 中提供本地代码仓库的路径,例如:

      install local mcp server from /path/to/my/local/mcp-server

使用示例 (与 Claude Desktop 集成后):

你可以向 Claude 提出类似这样的问题,来安装并使用其他的 MCP 服务器:

help me install playwright-mcp in my claude config read https://github.com/microsoft/playwright-mcp 然后帮我安装这个 mcp server

Claude 接收到指令后,会调用 'mcp-builder' 提供的工具,自动完成 MCP 服务器的安装和配置过程。 安装完成后,通常需要 重启客户端应用 (如 Claude Desktop) 才能使新的 MCP 服务器生效。

总而言之,'mcp-builder' 降低了用户手动安装和配置 MCP 服务器的复杂度,使得在 Claude 等客户端上扩展 MCP 功能变得更加便捷。

信息

分类

开发者工具