[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_111":112},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":47,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":59,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","eldesh","moduleId","random-mcp","@eldesh/random-mcp","displayName","random mcp","tagline","Generate random values and probability distribution samples.","iconKey","https://avatars.githubusercontent.com/u/379570?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://random-mcp.eldesh-tools.workers.dev/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1787719251000,"updatedAt",1788329715000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.eldesh%2Frandom-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1788043107000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/eldesh/random-mcp","githubRepoFullName","eldesh/random-mcp","releaseId","ext-eldesh-random-mcp","version","2.1.0","descriptionMarkdown","

\n $\"random-mcp$ \n

\n\n# random-mcp\n\nCloudflare Workers 上で動作する、乱数生成用の MCP（Model Context Protocol）サーバーです。Notion Agent などの MCP クライアントから、整数・浮動小数点数・重み付き選択・各種確率分布の標本を生成できます。\n\n公式サイト: [https://random-mcp.eldesh-tools.workers.dev/](https://random-mcp.eldesh-tools.workers.dev/)\n\n## 目的\n\n言語モデル自身に乱数を選ばせず、外部の乱数生成処理を MCP ツールとして呼び出せるようにすることを目的としています。\n\n言語モデルに乱数の選択を委ねると、モデルの学習データや出力傾向が結果に影響し、統計的に偏った値が生成されます。たとえば「1から10の整数をランダムに選べ」と指示しても、モデルは特定の値（7など）を好む傾向があり、まっとうな意味での乱数にはなりません。このため、乱数が必要な処理はモデルが自律判断するのではなく、本サーバーのツールを通じて生成する必要があります。\n\n乱数源には Web Crypto API を使用します。整数生成では、剰余による偏りを避けるため rejection sampling を行います。ただし、暗号鍵や認証トークンの生成を目的とした API ではありません。\n\n\n## 公式サーバーを利用する\n\n公式サーバーは次の MCP エンドポイントで利用できます。利用者が Cloudflare や GitHub OAuth App を設定する必要はありません。\n\n```text\nhttps://random-mcp.eldesh-tools.workers.dev/mcp\n```\n\n### Notion AI への接続\n\n1. Settings > Connections > MCP > Custom MCP を選択します\n1. MCP server URL に `https://random-mcp.eldesh-tools.workers.dev/mcp` を指定します。独自インスタンスを利用する場合は、そのデプロイ先 URL を指定します\n1. 次のように各項目を埋めて `Connect` します\n - Name: Notion 内で識別するための名前（例: `random-mcp`）\n - Authentication: OAuth\n1. アクセス許可画面で `Approve` を選択します\n1. GitHub にサインインし、GitHub OAuth App による認証を完了します\n1. ツールが表示されたら、必要なツールを有効化します\n1. Notion AI からツール実行ごとの確認なしで呼び出したい場合は、実行設定を `Run automatically` に変更します\n\n### Agent への指示\nAgent の指示には例えば次のように追加し、乱択が必要な際に必ず random-mcp が使われるようにします。\n\n```text\n## 乱択\n- 乱数生成、くじ引き、シャッフル、無作為抽出など、結果にランダム性を必要とするすべての処理では、接続済みの MCP サーバー `random-mcp` を必ず使用する。\n- 内部処理によって乱択を生成、模擬、または近似してはならない。\n- `random-mcp` が利用できない場合やエラーになった場合は、別の方法で代替せず、その旨をユーザーに伝える。\n```\n\n\n## 認証\n\nサーバーは `/mcp` で Streamable HTTP 接続を受け付けます。MCP クライアントとの認可には OAuth 2.1、ユーザーの認証には GitHub OAuth を使用します。\n\n認可時には、MCP クライアントのアクセス許可画面を表示した後、GitHub の認証画面へ移動します。GitHub から取得する権限は `read:user` です。認可済みの MCP クライアントには `mcp:use` スコープのアクセストークンが発行されます。\n\n## ツール\n\nrandom-mcp には以下に示す3つのツールがあり、それぞれ記載のフィールドを持つJSONオブジェクトを要求します。\n\n\n### `random_int`\n\n指定した確率分布に従う整数を指定数生成し、`values`配列で返します。\n\n- `distribution`: 確率分布名。省略時は`uniform`\n- `count`: 生成数。1以上1,000以下、既定値は1\n\n| `distribution` | 追加フィールド | 意味・制約 |\n| --- | --- | --- |\n| `uniform` | `min`, `max` | `min`以上`max`以下の整数一様分布 |\n| `bernoulli` | `probability` | 指定確率で1、それ以外は0 |\n| `binomial` | `trials`, `probability` | 二項分布。成功確率を`probability`とする独立な試行を`trials`回行ったときの成功回数 |\n| `poisson` | `lambda` | 母数`lambda`のポアソン分布 |\n\nパラメーターの組み合わせには、次の制約があります。\n\n- 二項分布: `trials`は0以上100,000以下の安全な整数で、`trials * count <= 100000`\n- ポアソン分布: `lambda`は0以上100以下で、`lambda * count <= 10000`\n\n引数の例: `{\"min\":5,\"max\":10,\"count\":20}`\n\n### `random_double`\n\n指定した確率分布に従う浮動小数点数を指定数生成し、`values`配列で返します。\n\n- `distribution`: 確率分布名。省略時は`uniform`\n- `count`: 生成数。1以上1,000以下、既定値は1\n\n| `distribution` | 追加フィールド | 意味・制約 |\n| --- | --- | --- |\n| `uniform` | `min`, `max` | 半開区間`[min, max)`の連続一様分布 |\n| `normal` | `mean`, `standard_deviation` | 平均と標準偏差を指定した正規分布 |\n| `lognormal` | `mu`, `sigma` | `log(X)`が平均`mu`、標準偏差`sigma`の正規分布に従う対数正規分布 |\n| `exponential` | `rate` | 率`rate`の指数分布。`rate > 0` |\n\n引数の例: `{\"distribution\":\"normal\",\"mean\":0,\"standard_deviation\":1,\"count\":20}`\n\n### `random_choice`\n\n候補から指定数の要素を選択し、`values`配列で返します。\n\n- `choices`: 候補文字列の配列。1個以上1,000個以下\n- `weights`: 各候補の相対的な重み。省略時は等確率\n- `count`: 選択数。1以上1,000以下、既定値は1\n- `with_replacement`: 復元抽出では`true`、非復元抽出では`false`。既定値は`true`\n\n`weights`を指定する場合は、`choices`と要素数を一致させ、少なくとも一つを正の値にします。\n非復元抽出では、`count`を候補数以下にする必要があります。重みを指定する場合は、正の重みを持つ候補数以下にする必要もあります。\n\n引数の例: `{\"choices\":[\"A\",\"B\",\"C\"],\"weights\":[1,2,1],\"count\":2,\"with_replacement\":false}`\n\n\n## ローカル開発\n\n### 必要な環境\n\n- Node.js 22.19.0以上\n- npm\n- GitHub アカウント\n\n依存関係をインストールします。\n\n```sh\nnpm install\n```\n\n### ローカル用 GitHub OAuth App の作成\n\n[GitHub の Developer settings](https://github.com/settings/developers) で、ローカル開発用の OAuth App を作成します。\n\n次の値を設定します。\n\n- Homepage URL: `http://localhost:8787`\n- Authorization callback URL: `http://localhost:8787/callback`\n\n作成後、Client ID と Client secret を取得します。このアプリケーションが GitHub に要求する OAuth スコープは `read:user` です。\n\n### 環境変数\n\nプロジェクト直下に `.dev.vars` を作成します。\n\n```dotenv\nGITHUB_CLIENT_ID=\nGITHUB_CLIENT_SECRET=\nCOOKIE_ENCRYPTION_KEY=\nGLAMA_MAINTAINER_EMAIL=\n```\n\n`GLAMA_MAINTAINER_EMAIL` は `/.well-known/glama.json` の応答内容を確認するための任意設定です。ローカルでこの確認をしない場合は省略できます。\n\n`COOKIE_ENCRYPTION_KEY` は、例えば次のコマンドで生成できます。\n\n```sh\nopenssl rand -hex 32\n```\n\n`wrangler.jsonc` のバインディング、互換日付、互換フラグ、または `.dev.vars` の変数名を変更した場合は、Workers ランタイムと環境変数の型定義を更新します。\n\n```sh\nnpm run types\n```\n\n生成される `worker-configuration.d.ts` はリポジトリへコミットします。型定義が設定と一致していることは `npm run typecheck` で確認できます。\n\n### 起動\n\nローカルサーバーを起動します。\n\n```sh\nnpm run dev\n```\n\n通常、MCP エンドポイントは次の URL になります。\n\n```text\nhttp://localhost:8787/mcp\n```\n\nランディングページは `http://localhost:8787/` で確認できます。\n\n> [!NOTE]\n> Wrangler が `Request.cf` を取得できないという警告を表示しても、最後に `Ready on http://localhost:8787` と表示され、このプロジェクトが `Request.cf` を使用していなければ動作確認を続けられます。\n\n### MCP Inspector による動作確認\n\nローカルサーバーを起動した状態で MCP Inspector の Web UI を起動します。\n\n```sh\nnpx --yes @modelcontextprotocol/inspector@latest\n```\n\nInspector で Streamable HTTP を選択し、接続先に `http://localhost:8787/mcp` を指定します。接続時にブラウザで OAuth の認可フローが開始されるため、アクセスを許可して GitHub 認証を完了します。本番環境を確認する場合は、接続先をデプロイ済みの MCP URL に変更します。\n\n接続後、Tools 画面に[ツール](#ツール)で示されているものが表示されることを確認します。\n\n> [!IMPORTANT]\n> 2026/08/20現在の MCP Inspector では random_int, random_double による入力型に対応したWebUIフォームは導出されません。\n> これらのツールの動作確認をする場合は MCP Inspector の CLI などを利用してください。\n\n## 独自インスタンスの構築\n\nこの章は、random-mcp の独自インスタンスを新たに Cloudflare Workers へ構築する場合の手順です。公式サーバーのデプロイには使用していません。\n\n構築には Cloudflare アカウントと、本番環境用の GitHub OAuth App が必要です。ローカル環境と本番環境ではコールバック URL が異なるため、OAuth App は環境ごとに作成してください。\n\n### 本番用 GitHub OAuth App の作成\n\n[GitHub の Developer settings](https://github.com/settings/developers) で OAuth App を作成し、次の値を設定します。\n\n- Homepage URL: デプロイ先 Worker のオリジン\n- Authorization callback URL: デプロイ先 Worker のオリジンに `/callback` を加えた URL\n\nたとえば、Worker のオリジンが `https://random-mcp.example.workers.dev` の場合、Authorization callback URL は `https://random-mcp.example.workers.dev/callback` です。\n\n作成後、Client ID と Client secret を取得します。このアプリケーションが GitHub に要求する OAuth スコープは `read:user` です。\n\n### Cloudflare リソースと Worker の設定\n\nOAuth の一時的な state を保存する Cloudflare KV namespace を作成します。次に、`wrangler.jsonc` で次の項目を独自インスタンス用に変更します。\n\n- `name`: Worker の名前\n- `kv_namespaces` の `OAUTH_KV` バインディングにある `id`: 作成した KV namespace の ID\n\n### Secret の登録\n\nCloudflare へログインします。\n\n```sh\nnpx wrangler login\n```\n\n本番用 GitHub OAuth App の認証情報と Cookie 暗号化キーを Cloudflare Secret として登録します。\n\n```sh\nnpx wrangler secret put GITHUB_CLIENT_ID\nnpx wrangler secret put GITHUB_CLIENT_SECRET\nnpx wrangler secret put COOKIE_ENCRYPTION_KEY\n```\n\n`COOKIE_ENCRYPTION_KEY` には、ローカル開発と同様にランダムな値を使用します。`.dev.vars` は Cloudflare へ自動的には反映されないため、本番 Worker で使用する値は Cloudflare Secret として登録する必要があります。\n\n### デプロイ\n\nGitHub OAuth App の Authorization callback URL がデプロイ先 Worker の `/callback` を指していることと、`wrangler.jsonc` の `OAUTH_KV` が利用可能な KV namespace を指していることを確認します。\n\nデプロイします。\n\n```sh\nnpm run deploy\n```\n\n公開 URL は通常、次の形式です。\n\n```text\nhttps://random-mcp..workers.dev/mcp\n```\n\nデプロイ後、公開された URL へ MCP クライアントまたは MCP Inspector から接続し、GitHub OAuth の認可とツールの呼び出しを確認します。\n\n## 公式サーバーのリリース\n\n公式サーバーは Cloudflare の Git 連携によってデプロイされます。`release` ブランチへの push を契機に自動デプロイされるため、公式環境のリリースに `npm run deploy` は使用しません。\n\n保守担当者向けの手順は [RELEASE.md](https://github.com/eldesh/random-mcp/blob/master/RELEASE.md) を参照してください。\n\n## ライセンス\n\n[MIT License](https://github.com/eldesh/random-mcp/blob/master/LICENSE) の下で公開しています。\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","iconType","image","upstream",{"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_109":110},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_97":59,"_98":59},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","io.github.eldesh/random-mcp","homepage","https://random-mcp.eldesh-tools.workers.dev/","packages",[],"ENV",{"_113":114,"_115":116,"_117":118},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]