# ランダム値生成MCPサーバー

ランダムな数値と文字列を生成するModel Context Protocol (MCP) サーバーです。

## 機能

- **ランダム数値生成**: 指定した範囲内のランダムな整数を生成
- **ランダム文字列生成**: 指定した長さのランダムな英数字文字列を生成
- **入力値検証**: 包括的なエラーハンドリングと検証
- **MCP準拠**: MCPプロトコル仕様との完全な互換性

## ツール

### generate_random_number
指定した範囲内のランダムな整数を生成します。

**パラメータ:**
- `min` (number): 最小値（含む）
- `max` (number): 最大値（含む）

**例:**
```json
{
  "name": "generate_random_number",
  "arguments": {
    "min": 1,
    "max": 100
  }
}
```

### generate_random_string
英数字（A-Z, a-z, 0-9）を使用して指定した長さのランダム文字列を生成します。

**パラメータ:**
- `length` (number): 生成する文字列の長さ（最小: 1）

**例:**
```json
{
  "name": "generate_random_string",
  "arguments": {
    "length": 10
  }
}
```

## インストール

1. リポジトリをクローン
2. 依存関係をインストール:
   ```bash
   npm install
   ```
3. プロジェクトをビルド:
   ```bash
   npm run build
   ```

## 使用方法

### 直接実行
```bash
node dist/index.js
```

### 起動スクリプト使用
```bash
./bin/start.sh
```

### MCPクライアント設定
MCPクライアントの設定に追加:
```json
{
  "mcpServers": {
    "random-value-server": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/random-value-mcp-server"
    }
  }
}
```

### Claude Code統合
このMCPサーバーをClaude Codeで使用するには:

1. サーバーがビルドされ準備完了していることを確認:
   ```bash
   npm run build
   ```

2. Claude Codeの設定にサーバー設定を追加。MCP設定ファイル（通常は `~/.config/claude-code/mcp.json` 、devcontainer内であれば `claude mcp add random-value-generator node /workspace/dist/index.js` など）を作成または編集:
   ```json
   {
     "mcpServers": {
       "random-value-server": {
         "command": "node",
         "args": ["dist/index.js"],
         "cwd": "/absolute/path/to/random-value-mcp-server"
       }
     }
   }
   ```

3. 新しいMCPサーバーを読み込むためClaude Codeを再起動

4. サーバーがClaude Codeセッションで利用可能になります。以下のようにして使用できます:
   - `generate_random_number` with `min` and `max` パラメータ
   - `generate_random_string` with `length` パラメータ

**Claude Codeでの使用例:**
```
1から100の間のランダムな数値を生成してください。
8文字のランダムな文字列を生成してください。
```

Claude Codeが自動的にMCPサーバーを使用してこれらのリクエストを処理します。

## テスト

テストスイートを実行:
```bash
node test/test-server.js
```

以下をテストします:
- サーバー初期化
- ツール一覧
- ランダム数値生成（有効・無効なケース）
- ランダム文字列生成（有効・無効なケース）
- エラーハンドリング

## 開発

- `npm run build`: TypeScriptコードをビルド
- `npm run dev`: 変更を監視して再ビルド
- `npm run clean`: ビルドアーティファクトをクリーン

## 技術詳細

- **プロトコル**: MCP (Model Context Protocol)
- **トランスポート**: STDIO
- **言語**: TypeScript/Node.js
- **SDK**: @modelcontextprotocol/sdk

## エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています:
- 無効なパラメータ範囲（数値でmin > max）
- 無効な文字列長（< 1）
- 必須パラメータの欠如
- 未知のツール名

すべてのエラーは適切なMCPエラーレスポンスとして説明的なメッセージと共に返されます。