MCP Hello World

🚀 MCP こんにちは

mcp-hello-world は、MCP プロトコルの実装をテストおよび検証するためのツールです。このツールは、開発者がリクエストを送信してレスポンスを受信できるシンプルなインターフェースを提供し、MCP 実装が正しく動作するかを検証することができます。

🚀 クイックスタート

サーバーの起動

MCP サーバーを起動するには、以下のコマンドを実行します。

npx mcp-hello-world

これにより、標準入力と標準出力を監視する MCP サーバーが起動します。

基本的な使用法

MCP サーバーに接続するクライアントを作成します。例えば、child_process を使用して新しいプロセスを生成することができます。

const {spawn} = require('child_process');
const mcpServer = spawn('npx', ['mcp-hello-world']);

このプロセスの標準入出力を介して、MCP リクエストを送信および受信できます。

✨ 主な機能

リソース

hello://world

• 説明：静的な「こんにちは、世界」リソースです。
• メソッド：resources/get
• パラメータ：なし
• 戻り値：{ data: 'こんにちは、世界！' }

greeting://{name}

• 説明：動的な挨拶リソースです。
• メソッド：resources/get
• パラメータ：名前は URI に含まれます。例：greeting://Bob
• 戻り値：{ data: 'こんにちは、{name}！' }（例：{ data: 'こんにちは、Bob！' }）

ツール

echo

• 説明：入力されたメッセージをエコーし、先頭に「こんにちは 」を付けます。
• メソッド：tools/invoke
• パラメータ：{ name: 'echo', parameters: { message: string } }
• 戻り値：{ content: [{ type: 'text', text: 'こんにちは {message}' }] }（例：{ content: [{ type: 'text', text: 'こんにちは test' }] }）

debug

• 説明：サーバーに登録されているすべての MCP メソッド定義を一覧表示します。
• メソッド：tools/invoke
• パラメータ：{ name: 'debug', parameters: {} }
• 戻り値：登録されているすべてのリソース、ツール、およびプロンプトを含む JSON 構造。

プロンプト

helpful-assistant

• 説明：基本的なアシスタントプロンプト定義です。
• メソッド：prompts/get
• パラメータ：なし
• 戻り値：system および user ロールを含むプロンプトの JSON 構造。

📦 インストール

mcp-hello-world は、npm を使用してインストールできます。

npm install mcp-hello-world

💻 使用例

標準入出力を使用する場合

const {spawn} = require('child_process');
const mcpServer = spawn('npx', ['mcp-hello-world']);

// 挨拶リクエストを送信
const request = {
    jsonrpc: '2.0',
    method: 'resources/get',
    params: ['hello://world'],
    id: 1
};

mcpServer.stdin.write(JSON.stringify(request) + '\n');

// レスポンスを監視
mcpServer.stdout.on('data', (data) => {
    console.log(data.toString());
});

HTTP を使用する場合

http://localhost:3000 にアクセスすることで、リクエストを送信できます。

📚 ドキュメント

設定

デフォルトでは、サーバーは標準入力と標準出力を監視します。環境変数を使用していくつかのオプションを設定することもできます。

• MCP_PORT: 監視するポートを設定します（デフォルトは 3000）

📄 ライセンス

[ここにライセンス情報を記載してください。例：MIT ライセンス]

このドキュメントは、mcp-hello-world の使用方法と統合方法に関する基本的なガイドを提供しています。何か質問や提案があれば、いつでもお問い合わせください！

貢献者

• [あなたの名前] - プロジェクトメンテナ