yomiyasuMCP

yomiyasuをChatGPTの会話から使う、Cloudflare Workers用のリモートMCPサーバーです。ChatGPTが推敲し、MCPが指示書・参照資料・機械検査を提供します。AI APIキーは不要です。

構成

ChatGPT → HTTPS /mcp → TypeScript Worker
                           ├─ 指示書・参照資料
                           ├─ レシートの署名・本文照合
                           └─ Service Binding → Python Worker（直接公開しない）
                                                    └─ 上流のlint・diff・資料照合

上流は 3.1.0 / db78b9bc5e868549b517a037df7a4d1c93edac23 に固定しています。upstream.jsonには取り込んだ42ファイルのSHA-256を記録しています。npm run prepare:dataが改変を検出し、配信用データを生成します。起動時にGitHubから最新版を取得しません。

Related MCP server: crosscheck

ChatGPTから使う

公開済みの接続先は https://yomiyasu-mcp.namiyama814.workers.dev/mcp です。自分で配置する場合は、後述のデプロイ手順で表示されるURLに /mcp を付けます。

接続用の非公開プラグイン定義は plugin/yomiyasu-mcp/、作成済みZIPは dist/yomiyasu-mcp.zip にあります。今回のアカウント登録は、ワークスペースの「MCPを含むプラグインを利用する権限」がなく拒否されました。サーバーは稼働中ですが、ChatGPTの実会話での確認は未実施です。登録には、その権限がある環境または管理者による権限設定が必要です。

OpenAIの接続手順に沿って登録します。アカウント・ワークスペースのポリシーにより、カスタムMCPの追加が制限される場合があります。

1. ChatGPT Pluginsを開き、追加ボタンから Add custom MCP server を選びます。

2. 名前を yomiyasu、接続先を https://<WorkerのURL>/mcp にします。認証は「なし」です。

3. 内容を確認して Create as a plugin を選び、検出された5つのツールを確認します。

4. 新しい会話で @ からyomiyasuを選び、次のように頼みます。

次の文章をyomiyasuで推敲してください。
get_instructionsから始め、必要な参照資料、lint、check、verifyを使ってください。

（原文）

verifyのmatches: trueを確認したあと、検査済みの本文を変更せずに提出する手順です。機械検査は意味保持や読みやすさの合格を示しません。

ローカル開発

Node.js 22以降、Python 3.12以降、uvが必要です。Python Workersの実行環境はpywranglerが準備します。

npm ci
cp .dev.vars.example .dev.vars

openssl rand -hex 32などで作ったランダムな値を、.dev.varsのRECEIPT_SECRETに設定してください。32バイト以上が必要です。.dev.varsはGit管理対象外です。

ターミナルを2つ使います。

# 1つ目: Python Worker（localhost:8788）
npm run dev:checker

# 2つ目: MCP Worker（localhost:8787）
npm run dev -- --port 8787

Wranglerの表示で CHECKER が local [connected] になっていることを確認します。

npm run typecheck
npm test
npm run test:integration

統合テストは実際のMCPクライアントから両Workerを呼び、初期化、5ツール、Python検査、引数検証、照合、並行呼び出しを検証します。npm testには上流CLIとの結果一致テストも含まれます。

デプロイ

Python WorkersとCloudflareのMCPガイドを利用しています。Python Workerを先に、同一Cloudflareアカウントに配置します。

npx wrangler login
# 複数アカウントがある場合は、配置するアカウントを指定します。
export CLOUDFLARE_ACCOUNT_ID=<your-account-id>
npm run deploy:checker
npm run deploy
npx wrangler secret put RECEIPT_SECRET

Secretには本番専用のランダムな値を入力します。未設定・32バイト未満の場合、checkは検査前に失敗します。Secretを変更すると、変更前のレシートは検証できなくなります。Python Workerの workers_dev と preview_urls は無効です。

MCP_URL=https://<WorkerのURL>/mcp npm run test:integration

実デプロイを使った統合テストが通ったらChatGPTへ登録し、上の例文でツール選択と提出までの動作を確認してください。MCPクライアントのテストと、ChatGPTが実際に指示書に従うことの確認は別です。

MCPツール

doc_type: pr, article, incident, proposal, minutes, manual, slides, essay, formal, promo, mail, paper, script。 reader: expert, informed, general。stance: 勧め, 決まり, 説明。指定しない値は省略します。materialsは資料本文の配列で最大16件です。

検査・照合対象の本文合計はUTF-8で 128 KiB までです。JSONエンベロープは1 MiB、ツールの結果は4 MiBまでです。上限超過・上流差分の詳細省略・検査失敗はエラーにし、レシートを発行しません。自動分割や結果の切り捨ては行いません。

レシートはHMAC-SHA-256で署名し、原文・最終稿・資料のハッシュ、検査条件、実行した検査、上流コミット、アダプター版を含めます。本文は含めません。改行・末尾改行・BOMを含め、渡された本文のUTF-8バイト列をそのまま照合します。レシートは検査の実施と本文一致を確認するためのもので、人の承認や推敲品質の証明には使いません。

元のCLIとの対応と制限

• lintは上流のlint_text、checkは原文・最終稿のlint_text、diff、資料があるときのgroundを呼びます。検査アルゴリズムは変更していません。

• yomiyasu_check.py run/verifyは呼びません。CLIの状態フォルダ、履歴、再実行管理、フック、ローカル辞書、元ファイル更新は対象外です。

• MCPのverifyは署名付きレシートを使う独自の本文照合です。CLIの記録や状態行を生成しません。

• CLIの読み込み時の改行・BOM正規化は行いません。直接関数に渡す内容はMCPの入力文字列そのものです。

• ChatGPTによる意味の確認、候補の判断、最終稿の提出はChatGPT側で実施します。本文だけを返す依頼でも、検査手順は同じです。

データの扱い

認証はありません。URLを知る第三者も利用でき、Cloudflareの利用枠を消費します。検査時には原文、推敲後本文、指定された資料をCloudflareに送ります。

アプリケーションは本文をDB・KV・R2・ファイルへ保存せず、ログにも出しません。本文は検査中にメモリ上で扱います。Pythonの一時ファイルに置くのは公開済みの参照資料だけです。両WorkerのObservabilityは無効にしています。Cloudflareや利用するチャットサービス側のデータ取り扱いは、それぞれの設定・規約に従います。

ライセンス

このリポジトリはMITです。上流のMITライセンスとUnicodeデータのライセンスは、それぞれ checker/src/vendor/LICENSE と checker/src/vendor/UNICODE-LICENSE.txt に同梱しています。固定した上流スナップショットは checker/src/vendor/ にあります。