mcpField
H
Hello MCP Server

Hello MCP Server

本地服务
github.com/cjavier开发工具082 周前更新
代码仓库

关于 Hello MCP Server

Hello MCP Server 是基于 Forge 任务运行器构建的 TypeScript MCP 服务，供开发者连接 Claude 等兼容助手与外部服务和数据。Forge 任务会自动作为 MCP 工具提供。

主要功能

  1. 01集成 Forge 任务运行器
  2. 02将任务作为 MCP 工具提供
  3. 03通过 Forge CLI 直接运行任务
  4. 04支持 MCP Inspector 测试

适用场景

  1. 01向 MCP 助手提供自定义 Forge 任务
  2. 02传入代码运行股票价格任务
  3. 03在 MCP Inspector 中测试工具及响应

MCP 相关

服务将 Forge 运行器中注册的任务作为工具提供给 MCP 客户端。可配置用于 Claude Desktop，也可通过 MCP Inspector 测试。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "McpServerBasic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Hello MCP Server

这是一个模型上下文协议（MCP）服务实现，可让 AI 助手与外部服务和数据源交互。该服务旨在与 Claude 及其他兼容 MCP 的 AI 助手配合使用。

前置条件

  • Node.js（v18 或更高版本）
  • pnpm 包管理器
  • force CLI，使用 pnpm i -g @forgehive/forge-cli 安装

安装

克隆仓库并安装依赖：

git clone <repository-url>
cd hello-mcp-server
pnpm install

构建

使用以下命令构建项目：

pnpm run build

这会将 TypeScript 编译为 JavaScript，并输出到 dist 目录。

直接运行任务

你可以使用 Forge runner 直接运行单个任务：

# Run the stock price task with a ticker parameter
forge task:run stock:price --ticker AAPL

添加到 Claude Desktop

要将此服务与 Claude Desktop 配合使用：

  1. 使用 pnpm run build 构建项目
  2. 修改 Claude Desktop 配置文件：

使用 nano: ~/Library/Application Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "hello-mcp-server": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH_TO_PROJECT/hello-mcp-server/dist/index.js"
            ]
        }
    }
}

将 ABSOLUTE_PATH_TO_PROJECT 替换为项目目录的实际绝对路径。

使用 MCP Inspector

调试和测试 MCP 服务时，可以使用 MCP Inspector 工具：

npx @modelcontextprotocol/inspector ABSOLUTE_PATH_TO_PROJECT/hello-mcp-server/dist/index.js

Inspector 提供 Web 界面，可用于测试服务的工具并查看其响应。

开发

添加新任务：

  1. 使用 Forge CLI 创建新任务：

    forge task:create MODULE:TASK_NAME

    这会在 src/tasks/MODULE/TASK_NAME.ts 中生成任务模板文件。

  2. 使用 Forge Task API 在生成的文件中实现任务。

  3. 在 runner 中注册任务（src/runner.ts）：

    import { yourTask } from './tasks/module/your-task';

// Add your task to the runner
runner.load('your_task_name', yourTask);

  4. 使用 pnpm run build 构建项目

服务会自动将 runner 中的所有任务注册为 MCP 工具，无需手动将它们添加到 src/index.ts 文件中。

更多资源

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。