Random Number MCP Server

🚀 ランダム数 MCP サーバー

このプロジェクトは、シンプルなモデルコンテキストプロトコル（MCP）サーバーを実装し、random.org API を使用して乱数を生成するツールを提供します。

🚀 クイックスタート

このサーバーは、MCP の基本概念を実演します。以下の内容が含まれます：

• MCP サーバーのセットアップ。
• ツールの定義と実装。
• 外部 API の統合。
• MCP クライアントで使用するためのサーバーの設定。

✨ 主な機能

このサーバーは、random.org API を使用して本物の乱数を生成します。基本的な使用には API キーは必要ありません。

📦 インストール

前提条件

• Node.js と npm がインストールされていること。
• Claude デスクトップアプリケーションなどの MCP クライアントがあること。

プロジェクトのセットアップ

1. リポジトリをクローンする：

   git clone [repository_url]
   cd [project_directory]
   

2. 依存関係をインストールする：

   npm install
   

💻 使用例

基本的な使用法

サーバーは index.ts で実装され、@modelcontextprotocol/sdk を使用して MCP 通信を処理します。

ツール：get_random_number

このツールは、random.org API からランダムな整数を取得します。

入力パラメータ：

• max（オプション）：最大値を指定する整数（含む）。デフォルトは 100 です。

出力：

• ランダムな数字を含む文字列。

📚 ドキュメント

サーバーの設定

サーバーは cline_mcp_settings.json ファイルで設定されます。このサーバーにエントリを追加し、実行するコマンドを指定する必要があります：

{
  "mcpServers": {
    "random-number": {
      "command": "node",
      "args": ["[path/to/index.js]"],
      "env": {}
    }
  }
}

[path/to/index.js] を実際の index.js ファイルのパスに置き換えてください（通常、npm run build を実行した後は build または dist ディレクトリにあります）。

サーバーの実行

1. サーバーをビルドする

   npm run build
   

2. サーバーを起動する（これは通常、MCP クライアントの設定後に自動的に行われます）。

使用方法

サーバーが実行され、設定されたら、MCP クライアントを通じて get_random_number ツールを使用できます。