Hello MCP Server K7b

🚀 MCPサーバーのご利用を歓迎いたします

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol, MCP）を実装しており、AIアシスタントが外部サービスやデータソースと相互作用できるようにします。このサーバーは、Claudeやその他のMCP互換のAIアシスタントと連携するように設計されています。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントが外部サービスやデータソースとのやり取りを行えるようになります。以下に、サーバーのセットアップや使用方法を説明します。

✨ 主な機能

• モデルコンテキストプロトコル（MCP）を実装し、AIアシスタントと外部サービスやデータソースのやり取りを可能にします。
• Claudeやその他のMCP互換のAIアシスタントと連携可能です。
• 新しいタスクを簡単に追加でき、サーバーが自動的にそれらをMCPツールとしてロードします。

📦 インストール

前提条件

• Node.js (v18以上)
• pnpmパッケージマネージャー
• force CLI（pnpm i -g @forgehive/forge-cliでインストール）

手順

1. リポジトリをクローンし、依存関係をインストールします。

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は、サーバーのツールをテストし、その応答を確認するための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ファイルに手動で追加する必要はありません。