Hello MCP Server K7b

🚀 欢迎使用MCP服务器

这是一个实现模型上下文协议（Model Context Protocol, 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 运行器直接运行单个任务：

# 使用股票代码参数运行股票价格任务
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 提供了一个网络界面，用于测试服务器的工具并查看其响应。

🔧 技术细节

开发新任务

要添加新任务，可按以下步骤操作：

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文件中手动添加。