关键词

ClaudeMCP工具集成效率工具桌面应用扩展

Hello-MCP 使用说明

项目简介

Hello-MCP 是一个实用工具，旨在帮助用户轻松地将 Claude 桌面应用与外部工具连接起来，通过 Model Context Protocol (MCP) 实现功能扩展。它提供了一键安装、多种运行模式和内置示例工具，方便用户快速上手并定制自己的 MCP 工具。

主要功能点

  • 简化 Claude MCP 设置: 提供向导式安装，自动配置 Claude 桌面应用以连接 MCP 服务器。
  • MCP 服务器模式: 作为一个 MCP 服务器运行，为 Claude 提供工具和服务。
  • 内置示例工具: 预置了如发送邮件、简单计算等工具，方便用户体验和学习。
  • 可扩展性: 允许用户轻松添加自定义的 MCP 工具，扩展 Claude 的能力。
  • CLI 命令行模式: 除了作为 MCP 服务器，还可以作为命令行工具使用，直接调用预设功能。

安装步骤

  1. 安装 Node.js: 确保你的系统中已安装 Node.js (版本 >= 14)。
  2. 安装 Claude 桌面应用: 如果尚未安装，请先安装 Claude 桌面应用 (下载地址)。
  3. 运行 Hello-MCP: 在终端中运行以下命令，即可无需安装直接使用 Hello-MCP： 
    npx hello-mcp
    这将启动设置向导，引导你完成配置过程。

服务器配置

要将 Hello-MCP 配置为 Claude 桌面应用的 MCP 服务器，你需要在 Claude 的配置文件中添加或修改 MCP 服务器配置。Hello-MCP 提供了自动配置功能，通过运行 'npx hello-mcp' setup 向导即可完成配置。

以下是 Hello-MCP 服务器的配置信息示例，通常由 Hello-MCP 自动写入 Claude 桌面应用的配置文件 ('claude_desktop_config.json')，你也可以手动配置（不推荐）：

{
  "mcpServers": {
    "garak": {
      "command": "npx",
      "args": [
        "-y",
        "github:hongsw/hello-mcp",
        "mcp-server"
      ],
      "env": {
        "GARAK_API_KEY": "YOUR_API_KEY",  // 你的 Garak API 密钥，由 Hello-MCP 自动生成和配置
        "GARAK_API_BASE": "http://localhost:3000" // Garak API 服务器地址，通常为本地地址
      }
    }
  }
}

配置参数说明:

  • 'server name': 服务器名称，这里是 "garak"。
  • 'command': 启动 MCP 服务器的命令，这里使用 'npx' 直接运行 GitHub 仓库中的 'hello-mcp'，并指定 'mcp-server' 模式。
  • 'args': 传递给启动命令的参数，'-y' 表示跳过 npm 包安装确认。
  • 'env': 环境变量配置，包括：
    • 'GARAK_API_KEY': 重要，用于 API 鉴权的密钥，由 Hello-MCP 在设置过程中生成并自动配置。
    • 'GARAK_API_BASE': Garak API 服务器的基础 URL，用于工具功能（如发送邮件）的后端支持，默认为本地地址。

注意: 通常情况下，你无需手动修改此配置，'npx hello-mcp' setup 命令会自动完成配置。

基本使用方法

  1. 启动 MCP 服务器: 当配置完成后，Hello-MCP 会在后台作为 MCP 服务器运行（通过 'npx hello-mcp mcp-server' 命令启动）。

  2. 在 Claude 中调用工具: 在 Claude 桌面应用中，你可以使用自然语言指令来调用 Hello-MCP 提供的工具。例如：

    • 输入 '1 add 1' 来执行加法计算。
    • 输入 '发送邮件到 [email protected] 内容是 Hello from Hello-MCP!' 来发送邮件。

    你也可以尝试更复杂的指令，例如：'请发送邮件到 [email protected]，内容为 "2 加 3 的结果是多少？"，并在邮件中包含计算结果。' (Claude 会先调用 'add' 工具计算 2+3，然后再调用 'send-email' 工具发送邮件)。

  3. 探索更多: 访问 https://garak.ai/getting-started 获取更多使用示例和技巧。

提示: Hello-MCP 默认收集匿名使用数据以改进服务，你可以在配置中禁用遥测功能。

信息

分类

桌面与硬件

访问项目