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 编译为 dist 目录中的 JavaScript。

直接运行任务

您可以使用 Forge 运行器直接运行单个任务：

# 使用股票代码参数运行股票价格任务
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

该检查器提供了一个 Web 界面来测试服务器的工具并查看其响应。

开发

要添加新任务：

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

   forge task:create MODULE:TASK_NAME
   

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

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

3. 在运行器中注册任务 (src/runner.ts)：

   import { yourTask } from './tasks/module/your-task';
   
   // 将您的任务添加到运行器
   runner.load('your_task_name', yourTask);
   

4. 使用 pnpm run build 构建项目

服务器将自动从运行器注册所有任务作为 MCP 工具，而无需手动将它们添加到 src/index.ts 文件中。

附加资源

• 模型上下文协议文档
• MCP 快速入门指南