Hello MCP Server

Hello MCP サーバー

これは、AI アシスタントが外部サービスやデータソースとやり取りできるようにする、Model Context Protocol（MCP）サーバーの実装です。このサーバーは、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 ランナーを使用して、個々のタスクを直接実行できます。

# 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. ランナー（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 でプロジェクトをビルドします。

サーバーは、src/index.ts ファイルに手動で追加しなくても、ランナーに登録されたすべてのタスクを MCP ツールとして自動的に登録します。

参考資料

• Model Context Protocol ドキュメント
• MCP クイックスタートガイド