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 の環境も、手作業での設定も要りません。
- v0.26.0 の記事で紹介したインストールスクリプトを実行します。すでに使っている場合も、同じスクリプトで更新できます
- 続けて
mcp-rs initを実行し、サイトの URL、ユーザー名、アプリケーションパスワードを入力します - 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 でお待ちしています。