お知らせ 実装記録 技術信頼性

mcp-rs v0.27.0公開:セキュリティとセットアップの強化

mcp-rs は、AI エージェントから WordPress を操作するための、Rust 製 MCP(Model Context Protocol)サーバーです。Claude などの AI に話しかけるだけで、記事の下書きからメディアの登録、サイト設定の変更までを任せられます。

2026年11月17日に、v0.27.0 を公開しました。今回の柱は、セキュリティとセットアップの強化です。コードを点検し、HTTP モード、プラグイン、データベースの守りを固めました。あわせて、mcp-rs init が以前の設定を引き継げるようになり、ビルド済みファイルには GitHub の出所の証明が付くようになりました。

v0.27.0 のポイント

分野内容
HTTP モード何も送らない接続を閉じ、認証の失敗の回数に上限を設ける。リバースプロキシの後ろでは認証を必須に
プラグイン読み取りだけの API キーから呼び出せるプラグインのツールを、確かめたものに限る
データベースサーバーの証明書の確認を厳しくし、行のロックとサーバーの関数を断る
ツールの制限ツールを制限した呼び出し元には、一覧にあるツールだけを許す
初期設定mcp-rs init が、以前の設定ファイルにある設定を新しい設定に引き継ぐ
リリースビルド済みファイルに、GitHub の出所の証明を付ける

HTTP モード

  • 何も送らない接続を閉じる:処理中のリクエストがないまま request_timeout_seconds(既定は30秒)が過ぎた接続を閉じます。これまでは、HTTP/2 の何も送らない接続によって、認証なしで max_connections を埋めることができました
  • 認証の失敗に上限:1分に20回認証に失敗したアドレスは、その1分の残りを 429 で断ります
  • プロキシの後ろでは認証を必須に:trusted_proxies を設定している場合は、API キーか OAuth の認証を求めます
  • 短い API キーを警告:16文字より短い API キーは、起動時に警告します
  • ログを守る:認証の失敗のログは、1分あたりの件数に上限を設けました。JWT の kid は、エスケープしてから書き込みます
  • WebSocket も検査:/ws のメッセージも、IDS で確かめます

プラグインの「読み取りだけ」のアノテーション

ツールが読み取りだけであることを示すアノテーション(readOnlyHint)は、プラグイン自身が付けるものです。プラグインが「読み取りだけ」と付ければ、@read_only の API キーやトークンから呼び出せてしまうため、v0.27.0 では、このアノテーションを既定では信頼しないようにしました。

内容を確かめたプラグインについては、[[plugins]] に trust_annotations = true を書くと、これまでどおりアノテーションを信頼します。この変更で呼び出せなくなるツールは、起動時にログへ書き出すので、どのツールが対象かをすぐに確かめられます。

データベース

  • 証明書の確認を厳しく:これまでの verify-ca は、公開の CA が発行したものであれば、どのホストの証明書でも受け入れていました。PostgreSQL では verify-full を使い、MySQL・MariaDB では ssl_root_cert を指定します
  • 行のロックとサーバーの関数を断る:行のロックと、サーバーのファイルやほかの接続に触れる関数(LOAD_FILE()、sys_exec()、pg_read_file()、pg_ls_*、lo_import()、dblink*、pg_terminate_backend() など)を断ります。本来の守りは、データベースのユーザーに権限を与えないことです。この検査は、2つ目の守りです
  • SQL の検査を点検:MySQL・MariaDB の SQL の検査を点検し直しました。検査とサーバーとで、読み方の食い違いは見つかりませんでした。MySQL 8.4 と MariaDB 11.4 の結合テストで確かめています

ツールの制限

呼び出せるツールを制限した呼び出し元について、扱いを厳しくしました。

  • 一覧にあるツールだけを許す:一覧にないツールの呼び出しは、許可しません
  • 状態の詳細を見せない:mcp_rs_status は、ツールを制限した呼び出し元には、設定ファイル、ログの場所、ハンドラーとプラグインの状態を表示しません

設定を引き継ぐ mcp-rs init

v0.26.0 で加えた mcp-rs init が、以前の設定を引き継げるようになりました。手作業で登録していた設定にあるプラグインなども、そのまま新しい設定に写せます。

  • 設定を引き継ぐ:置き換える登録の設定ファイルにしかない設定([[plugins]]、[database] など)を一覧にし、新しい設定に写せます
  • 平文のパスワードを残さない:バックアップに平文のパスワードがあれば、消すかどうかを尋ねます
  • ファイルの権限:Unix では、設定ファイルを 600、フォルダを 700 にします
  • 安全に書き込む:設定ファイルは、一時ファイルに書いてから置き換えます

ビルド済みファイルの出所の証明

ビルド済みファイルに、GitHub の出所の証明(build provenance attestation)を付けるようにしました。ダウンロードしたファイルが、このリポジトリのビルドで作られたものかどうかを、GitHub CLI で確かめられます。

gh attestation verify <ファイル> -R n-takatsu/mcp-rsCode language: Bash (bash)

あわせて、ビルド済みファイルに README.ja.md も入れるようにしました。

以前のバージョンから更新する場合

stdio モードで WordPress のツールだけを使っている場合は、これまでの設定のまま使えます。次に当てはまる場合は、設定を確かめてください。

  • HTTP モードでリバースプロキシの後ろに置いている:trusted_proxies を設定している場合、API キーか OAuth の認証がないと、mcp-rs は起動しません。mTLS は、プロキシの後ろでは認証に数えません。プロキシの側で認証している場合は、allow_unauthenticated_external = true で明示します
  • @read_only の API キー・トークンを使っている:プラグインのツールを、既定では含めなくなりました。内容を確かめたプラグインは、[[plugins]] に trust_annotations = true を書くか、ツールを名前で許可します
  • データベースで ssl_mode = "verify-ca" を使っている:PostgreSQL では verify-full を使ってください。MySQL・MariaDB では、ssl_root_cert が必要です。条件を満たさない設定では、データベースのツールは起動せず、mcp_rs_status に理由を表示します
  • 呼び出し元のツールを制限している:一覧にないツールは許可しません。また、mcp_rs_status は、設定ファイル、ログの場所、ハンドラーとプラグインの状態を表示しなくなります
  • execute_query・execute_command を使っている:行のロック(FOR UPDATE など)、サーバーのファイルやほかの接続に触れる関数、PostgreSQL の U&"…"、MySQL のヒント SET_VAR を断るようになりました

mcp-rs をはじめる

必要なのは、アプリケーションパスワードを発行した WordPress サイトです。Rust の環境も、手作業での設定も要りません。

  1. v0.26.0 の記事で紹介したインストールスクリプトを実行します。すでに使っている場合も、同じスクリプトで更新できます
  2. 続けて mcp-rs init を実行し、サイトの URL、ユーザー名、アプリケーションパスワードを入力します
  3. AI に「mcp-rs の状態を確かめて」と頼みます。mcp_rs_status で、バージョンや WordPress への接続の状態を確かめられます

ビルド済みバイナリについては v0.25.0 の記事で、OS の資格情報ストアについては v0.24.0 の記事で紹介しています。

さいごに

redring.jp は、引き続き Claude から mcp-rs を通じて運用しています。この記事の下書きも、v0.27.0 に更新した mcp-rs で作成しました。

ライセンスは MIT と Apache-2.0 のデュアルライセンスです。変更の全体は CHANGELOG にまとめています。感想や不具合の報告は GitHub Issues でお待ちしています。

mcp-rs v0.27.0 を GitHub で見る

-お知らせ, 実装記録, 技術信頼性
-, , , , , , , ,

Optimole による最適化