Mcpserverbasic

🚀 你好 MCP 服務器

這是一個實現模型上下文協議（Model Context Protocol, MCP）的服務器，允許 AI 助手與外部服務和數據源進行交互。該服務器專為 Claude 和其他與 MCP 兼容的 AI 助手設計。

🚀 快速開始

本服務器實現了模型上下文協議（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 運行器：

# 使用ticker參數運行股票價格任務
forge task:run stock:price --ticker AAPL

添加到 Claude 桌面

要在 Claude 桌面中使用該服務器：

1. 使用 pnpm run build 構建項目。
2. 修改 Claude 桌面配置文件： 使用 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 檢查器

為了調試和測試你的 MCP 服務器，你可以使用 MCP 檢查器工具：

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

檢查器提供一個網絡界面來測試你的服務器工具及其響應。

📚 詳細文檔

開發新任務

要添加新任務：

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 快速入門指南