Mcpserverbasic

🚀 こんにちは MCP サーバー

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

🚀 クイックスタート

この MCP サーバーを使用することで、AI アシスタントが外部サービスやデータソースとのやり取りを可能にします。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• 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

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

📚 ドキュメント

追加リソース

• モデルコンテキストプロトコルドキュメント
• MCP クイックスタートガイド