MCP (mcp Server Diceroll)

🚀 MCP サーバーサイコロ (mcp-server-diceroll)

このプロジェクトは、MCP（モデル呼び出しプロトコル）に基づくシンプルなサーバーのデモです。このサーバーは、基本的な数値演算機能とカスタマイズ可能なサイコロ機能を提供します。

✨ 主な機能

• 数値の足し算
• 面の数と回数をカスタマイズできるサイコロ
• UUID 生成（バージョン 4 またはバージョン 1 をサポート）
• 動的な挨拶文生成

📦 インストール

システム要件

• Python 3.12 以上
• mcp ライブラリ 1.6.0 以上
• uv (Python パッケージ管理ツール)

インストール手順

1. コードリポジトリをクローンします：

git clone https://github.com/yourusername/mcp-server-diceroll.git
cd mcp-server-diceroll

2. uv がまだインストールされていない場合は、以下のコマンドを実行してインストールします：

curl -sSf https://astral.sh/uv/install.sh | bash

3. uv を使用して仮想環境を作成し、依存関係をインストールします：

uv venv
source .venv/bin/activate  # macOS/Linux 用
# または
.venv\Scripts\activate  # Windows 用

uv pip install -e .

💻 使用例

基本的な使用法

サーバーを起動します：

python server.py

または uv を使用して実行します：

uv run python server.py

起動後、以下のツールを使用できます：

1. add - 2つの数値を足し算します
2. roll_dice - サイコロを振ります（デフォルトは6面体1回）
3. generate_uuid - UUID を生成します（デフォルトはバージョン 4、バージョン 1 指定もサポート）
4. greeting://{name} - 指定された名前を含む挨拶文を生成します

📚 ドキュメント

参考資料

• サイコロから始めるモデルコンテキストプロトコル (MCP) の理解
• Anthropic MCP 公式リリース
• modelcontextprotocol/python-sdk

サンプル

サーバーにリクエストを送信する方法については、MCP クライアントドキュメントを参照してください。