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