使用说明

项目简介

MegaTool 是一个集成了多种实用 MCP 服务器的命令行工具,旨在为 LLM 应用提供上下文信息和功能扩展。它通过简单的命令行界面,可以运行和管理不同的 MCP 服务器。

主要功能点

  • 资源管理: 通过 GitHub 服务器可以访问和管理 GitHub 仓库和用户信息。
  • 工具注册与执行: 提供计算器工具,用于执行算术运算;提供包版本检查工具,用于获取各种编程语言的包最新版本。
  • Prompt 模板: 虽然仓库中没有明确提及 Prompt 模板,但作为 MCP 服务器,它具备支持 Prompt 模板的潜力,可以通过扩展来实现。
  • 会话管理和能力声明: 作为 MCP 服务器,MegaTool 负责会话管理和能力声明,通过 JSON-RPC 协议与客户端通信。
  • 多种传输协议支持: 支持 Stdio 和 SSE 传输协议,可以灵活地与不同的 MCP 客户端集成。

安装步骤

  1. 从 GitHub Releases 下载 (推荐)

    访问 https://github.com/simoncollins/megatool/releases 下载预编译的二进制文件。 例如,Linux 系统可以下载 'megatool-v1.0.0-linux-amd64.tar.gz' 并解压到 '/usr/local/bin' 目录:

    tar -xzf megatool-v1.0.0-linux-amd64.tar.gz -C /usr/local/bin
  2. 使用 Go 安装

    确保已安装 Go 环境。运行以下命令安装:

    go install github.com/simoncollins/megatool@latest
  3. 从源代码安装

    首先克隆仓库:

    git clone https://github.com/simoncollins/megatool.git
    cd megatool

    然后使用 'just' (或者 'make') 构建并安装:

    just install

    或者

    make install

    详细安装步骤请参考 安装指南

服务器配置

{
  "mcpServers": {
    "calculator": {
      "server name": "calculator",
      "command": "megatool",
      "args": [
        "run",
        "calculator"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    },
    "github": {
      "server name": "github",
      "command": "megatool",
      "args": [
        "run",
        "github"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    },
    "package-version": {
      "server name": "package-version",
      "command": "megatool",
      "args": [
        "run",
        "package-version"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明:

  • 'mcpServers': 定义所有 MCP 服务器配置的 JSON 对象。
  • 'calculator', 'github', 'package-version': 预配置的服务器名称。
  • 'server name': 服务器的名称,用于标识配置。
  • 'command': 启动 MCP 服务器的命令,这里都是 'megatool'。
  • 'args': 启动命令的参数:
    • '"run"': 'megatool' 命令的子命令,用于运行服务器。
    • '"calculator"', '"github"', '"package-version"': 指定要运行的服务器名称。
  • 'env': 环境变量,默认为空。
  • 'disabled': 是否禁用此服务器,默认为 'false'(启用)。
  • 'autoApprove': 自动批准的工具列表,默认为空。

基本使用方法

  1. 运行 MCP 服务器

    使用 'megatool run <server-name>' 命令运行指定的 MCP 服务器。 例如,运行 'calculator' 服务器:

    megatool run calculator

    其他可用服务器名称包括 'github' 和 'package-version'。

  2. 配置服务器 (首次运行 GitHub 服务器前)

    某些服务器可能需要配置才能使用,例如 'github' 服务器需要配置 GitHub Personal Access Token (PAT)。 使用 '--configure' 标志来配置服务器:

    megatool run github --configure
  3. 使用 SSE 模式运行服务器

    使用 '--sse' 标志和 '--port' 标志可以以 SSE (Server-Sent Events) 模式运行服务器,并指定端口:

    megatool run calculator --sse --port 3000

    客户端需要配置 SSE 连接地址 'http://localhost:3000/sse/sse' (根据实际仓库代码调整,此处假设为 '/sse/sse') 来连接服务器。

  4. 查看日志

    使用 'megatool logs <server-name>' 命令查看服务器日志。例如,查看 'calculator' 服务器的日志:

    megatool logs calculator

    可以使用 '-f' 或 '--follow' 标志实时跟踪日志输出。

  5. 列出运行中的服务器

    使用 'megatool ps' 命令列出当前正在运行的 MCP 服务器及其 PID 和启动时间。

  6. 停止运行中的服务器

    使用 'megatool stop <server-name>' 命令停止指定的 MCP 服务器。例如,停止 'calculator' 服务器:

    megatool stop calculator

信息

分类

开发者工具