mcp-rs は、AI エージェントから WordPress を操作するための、Rust 製 MCP(Model Context Protocol)サーバーです。Claude などの AI に話しかけるだけで、記事の下書きからメディアの登録、サイト設定の変更までを任せられます。
2026年11月15日に、v0.24.0 を公開しました。今回の柱は2つです。1つは、WordPress の認証情報を OS の資格情報ストアから読み込めるようにしたことです。もう1つは、セキュリティの見直しで見つかった点への対応です。あわせて、設定ファイルの例を現在の書式に合わせて整理しました。
ご注意:v0.24.0 には、更新するときに対応が必要な変更が4つあります。以前のバージョンをお使いの方は、先に「以前のバージョンから更新する場合」をご覧ください。
v0.24.0 のポイント
| 分野 | 内容 |
|---|---|
| 認証情報 | WordPress の認証情報を OS の資格情報ストアに保存し、どこから起動しても同じものを使える |
| HTTP モード | 外部から届くアドレスで待ち受けるときは認証を必須に。接続数・リクエストの大きさ・受信の時間に上限を追加 |
| データベース | 結果の大きさに上限を追加。証明書の設定が誤っているときは、検証なしで接続せずに失敗する |
| ログと秘密情報 | ログファイルを所有者だけが読める権限で作成。設定エラーの文に値を出さない |
| 設定例 | configs/ の例を、mcp-rs が実際に読む書式に合わせて整理 |
OS の資格情報ストア
これまで、WordPress のユーザー名とアプリケーションパスワードは、環境変数か設定ファイルで渡していました。ところが、Claude Desktop は JSON の設定の env に書いた変数しか mcp-rs に渡しません。そのため、Claude Desktop、Claude Code、ターミナルのそれぞれに、同じ認証情報を書く必要がありました。パスワードを替えたときに、どこか1か所を更新し忘れると接続できなくなります。
v0.24.0 では、認証情報を OS の資格情報ストアに1回保存すれば、どこから起動しても同じものを使えるようになりました。設定ファイルの [handlers.wordpress] に、username と password の代わりに keyring を書きます。
[handlers.wordpress]
url = "https://your-wordpress-site.com"
keyring = "my-site"
enabled = trueCode language: TOML, also INI (ini)
続いて、次のコマンドで、サイトの URL、ユーザー名、アプリケーションパスワードを保存します。
mcp-rs wordpress-keyring set my-siteCode language: Bash (bash)
- 保存先は OS の仕組み:Windows の資格情報マネージャー、macOS のキーチェーン、Linux の Secret Service に保存します。設定ファイルにも、クライアントの設定にも、パスワードを書きません
- どこから起動しても同じ:Claude Desktop、Claude Code、ターミナルのどれから mcp-rs を起動しても、同じ資格情報ストアを読みます。クライアントの設定には、起動するコマンドを書くだけで済みます
- 別のサイトには送らない:保存した認証情報は、保存したサイトの URL が設定ファイルの
urlと一致するときだけ使います。設定を書き換えられても、パスワードが別のサイトに送られることはありません - API キーも環境変数で:HTTP モードの API キーを、
${VAR}の形で環境変数から読み込めるようになりました
これまでの username・password と、暗号化した認証情報(encrypted_credentials)も、引き続き使えます。詳しくは WordPress 連携のドキュメントをご覧ください。
セキュリティの見直し
v0.24.0 では、mcp-rs 全体のセキュリティを見直し、見つかった点に対応しました。多くは、HTTP モードで外部から接続を受ける場合と、データベースに接続する場合に関わるものです。
HTTP モード
- 外部で待ち受けるときは認証が必須:自分のパソコン以外から届くアドレスで待ち受ける場合は、API キー、OAuth、mTLS のいずれかを設定しないと起動しません
- 上限を追加:同時に受ける接続の数、リクエストの大きさ、受信にかける時間に上限を設けました
- WebSocket を閉じる条件:
/wsの接続は、通信が無いとき、トークンの期限が切れたとき、相手の受信が止まったときに閉じます。大きな応答は、回線が 64 KB/s より遅いと途中で打ち切られることがあります - 監査ログがあふれない:認証の失敗を監査ログに記録するのは、1分に1件までにしました
- ツールの制限をリソースにも:API キーごとに使えるツールを制限している場合、その制限をリソースにも適用します
プロキシと侵入検知
- プロキシのヘッダーは信頼した相手からだけ:プロキシが付けるヘッダーは、
trusted_proxiesに書いたアドレスから届いたときだけ信頼します - 呼び出し元の見分け方:侵入検知は、呼び出し元を
X-User-IDヘッダーではなく、認証した利用者または IP アドレスで見分けます。保持する記録の数にも上限を設けました - リプレイ対策:リプレイ攻撃を防ぐための nonce を、呼び出し元ごとに管理します
データベース
- 結果の大きさに上限:
execute_queryが返す結果の大きさに上限を設けました(既定 10 MB) - セッションの設定を残さない:接続を使い回しても、前の呼び出しのセッションの設定が残らないようにしました
- 証明書の設定が誤っていれば失敗:
ssl_root_certの指定が誤っている場合は、検証なしで接続せず、接続を失敗させます - スキーマの情報を追加:
get_schemaが、外部キーとインデックスも返すようになりました。NaN と ±Infinity は文字列で返します
ログと秘密情報
- ログファイルの権限:Unix では、ログファイルを所有者だけが読める権限で作成します
- エラーの文に値を出さない:設定のエラーの文に、設定の値を出さないようにしました。値がパスワードである場合があるためです
- 鍵の導出を強化:暗号化した認証情報の鍵の導出を、60万回の反復に引き上げました。これまでに作成したものもそのまま読めますが、新しい回数にするには作り直しが必要です
開発の体制とコードの整理
- CI:外部のアクションをコミットの SHA で固定し、ワークフローの権限を減らしました
- 使われていないコードの削除:認証の無い TCP サーバーや、単独の WebSocket サーバーなど、本体から使われていないコードを削除しました
設定例の整理
configs/ にある設定ファイルの例を、mcp-rs が実際に読む書式に合わせて整理しました。前回の v0.23.0 で進めた「書いてあることと実際にできることを一致させる」取り組みの続きです。
- 存在しないキーを削除:書いても無視されていたキーを例から除きました。「filesystem ハンドラー」の節も、その1つです
- 組み合わせの例:
examples/multi-handler.tomlで、WordPress、PostgreSQL、プラグインを一緒に使う設定を示しました - 例をテストで確認:設定例が古くならないよう、テストで読み込みを確かめるようにしました
- 効いていなかった設定の削除:
[transport.stdio]の設定は、何の効果も無かったため削除しました
以前のバージョンから更新する場合
次の4つは、該当する使い方をしている場合に対応が必要です。
- 設定ファイルの場所:
--configを指定しない場合、今いるフォルダの設定ファイル(mcp-config.toml、config.toml、config/mcp.toml)を読まなくなりました。--configに絶対パスを指定するか、ファイルを~/.config/mcp-rs/config.tomlに移してください - HTTP モードの認証:自分のパソコン以外から届くアドレスで待ち受ける場合は、API キー、OAuth、mTLS のいずれかが必要です。認証を手前のリバースプロキシなどで行っている場合に限り、
allow_unauthenticated_external = trueを設定します - プロキシのヘッダーを使う設定:
tls_enabledを使わないenforce_https、証明書のピン留め、ids_trust_forwarded_forを使う場合は、trusted_proxiesにプロキシのアドレスを書いてください。書いていないと起動しません - PostgreSQL の Docker Compose:PostgreSQL の定義を
docker-compose.postgres.ymlに分けました。POSTGRES_PASSWORDの既定値(changeme)を無くしたので、値を設定しないと起動しません
docker compose -f docker-compose.yml -f docker-compose.postgres.yml up -dCode language: Bash (bash)
Rust のライブラリとして使っている場合は、設定の構造体(HttpConfig、WordPressConfig、EncryptedCredentials など)にフィールドが増え、使われていなかった McpServer::run、StdioTransport、handlers::multi などを削除しました。バージョンを 0.24.0 に上げたのは、このためです。詳しくは CHANGELOG をご確認ください。
mcp-rs をはじめる
必要なのは、Rust の環境と、アプリケーションパスワードを発行した WordPress サイトです。ソースを取得してビルドします。
git clone --branch v0.24.0 https://github.com/n-takatsu/mcp-rs.git
cd mcp-rs
cargo build --releaseCode language: Bash (bash)
設定ファイルに keyring を書き、mcp-rs wordpress-keyring set で認証情報を保存したら、ビルドした mcp-rs を絶対パスで Claude Code に登録します。認証情報は資格情報ストアから読むので、登録のコマンドにパスワードを書く必要はありません。
claude mcp add mcp-rs --scope user \
-- /path/to/mcp-rs/target/release/mcp-rs --config /path/to/mcp-config.tomlCode language: Bash (bash)
登録したら、AI に「mcp-rs の状態を確かめて」と頼んでみてください。mcp_rs_status で、バージョンや WordPress への接続の状態を確かめられます。
さいごに
redring.jp は、引き続き Claude から mcp-rs を通じて運用しています。この記事の下書きも、v0.24.0 の mcp-rs で作成しました。資格情報ストアは、この運用の中で、認証情報を2か所に書いていて更新し忘れた経験から生まれた機能です。
ライセンスは MIT と Apache-2.0 のデュアルライセンスです。変更の全体は CHANGELOG にまとめています。感想や不具合の報告は GitHub Issues でお待ちしています。