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

mcp-rs v0.25.0公開:MySQL・MariaDB対応とビルド済みバイナリ

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

2026年11月17日に、v0.25.0 を公開しました。今回の柱は3つです。1つめは、データベースのツールが MySQL と MariaDB に対応したことです。2つめは、ビルド済みの mcp-rs を配布するようにしたことです。3つめは、設定が正しいかを確かめる mcp-rs check コマンドです。設定ファイルとツールに、互換性のない変更はありません。

v0.25.0 のポイント

分野内容
データベースMySQL と MariaDB に対応。PostgreSQL と同じツール、上限、監査ログが使える
配布Windows、macOS、Linux 向けのビルド済みの mcp-rs を、リリースごとに配布。Rust は不要
設定の確認mcp-rs check で、設定ファイル、認証情報、サイトへの接続、ログの書き込みを確かめられる
VS CodeGitHub Copilot のチャットから mcp-rs を使う手順を、README とウェブサイトに追加
修正接続の確認で、投稿者や寄稿者のアカウントが「到達できない」と誤って報告される問題を修正

MySQL と MariaDB

v0.23.0 で加えたデータベースのツールが、PostgreSQL に加えて MySQL(8.0 以降)と MariaDB(10.6 以降)でも使えるようになりました。execute_query、get_schema、execute_command の3つのツールも、結果の上限も、監査ログも、PostgreSQL と同じです。設定ファイルの engine に、"mysql" または "mariadb" を指定します。

[database]
engine = "mysql"             # MariaDB の場合は "mariadb"
host = "localhost"
port = 3306
database = "app"
username = "mcp_reader"
password = "${MCP_DB_PASSWORD}"

allow_write = false          # true で execute_command も使えるCode language: TOML, also INI (ini)

MySQL と MariaDB への対応は、既定のビルド、配布するバイナリ、Docker のイメージに含まれています。増える大きさは約 0.7 MB です。

AI に任せても安心な仕組み

  • 読み取りは本当に読み取りだけ:既定では読み取り専用です。execute_query は、START TRANSACTION READ ONLY の中で実行してからロールバックします
  • 値は SQL に埋め込まない:パラメーターは、? のプレースホルダーでデータベースに別に渡します
  • 時間の上限:SELECT の時間の上限には、MySQL では MAX_EXECUTION_TIME を、MariaDB では max_statement_time を使います。それ以外の場合は、別の接続から KILL QUERY を送って止めます
  • 行数と大きさの上限:行数または大きさの上限に達したら、残りの結果を捨てて接続を閉じます
  • 接続を使い回しても設定を残さない:プールに戻す接続は、COM_RESET_CONNECTION でリセットします
  • TLS:ssl_mode で設定します(allow 以外の値を使えます)。ssl_root_cert を指定した場合は、その認証局だけを信頼します
  • 種類は接続先で見分ける:MySQL か MariaDB かは、接続したサーバーのバージョンから判断します
  • 中身を調べられないコメントは拒否:MariaDB だけが実行するコメント(/*M! … */)は、中身を検査できないため拒否します

既知の問題:サーバーの sql_mode に NO_BACKSLASH_ESCAPES が含まれている場合、SQL の検査と文字列の解釈が食い違うことがあります。既定の設定では起きません。

ビルド済みの mcp-rs

これまで、mcp-rs を使うには Rust の環境を用意して、ソースからビルドする必要がありました。v0.25.0 からは、リリースごとにビルド済みの mcp-rs を配布します。Rust をインストールしなくても、ダウンロードするだけで使えます。

  • 対応する環境:Windows(x64)、macOS(Apple Silicon)、Linux(x64、glibc 2.35 以降)
  • ダウンロードの確認:それぞれのバイナリに .sha256 のファイルが付き、まとめた SHA256SUMS も配布します
  • 署名はありません:バイナリにコード署名はしていません。ダウンロード、確認、ブロックされたファイルを開く手順は、README にまとめています

設定を確かめる mcp-rs check

mcp-rs を AI のクライアントに登録したのに動かないとき、原因が設定ファイルにあるのか、認証情報にあるのか、サイトへの接続にあるのかを切り分けるのは手間でした。mcp-rs check は、クライアントを介さずに mcp-rs だけで設定を確かめます。

mcp-rs checkCode language: Bash (bash)
  • 設定ファイル:読み込めるかを確かめ、エラーがあれば行と理由を表示します
  • 認証情報:WordPress の認証情報を読み込めるかを確かめます
  • サイトへの接続:サイトに到達でき、認証が通るかを確かめます
  • ログ:ログと監査ログに書き込めるかを確かめます
  • 終了コード:エラーが1つでもあれば、終了コード 1 で終わります。スクリプトからも使えます

[database]、[[plugins]]、HTTP モードの設定は、まだ確かめません。

VS Code(GitHub Copilot)から使う

VS Code の Copilot のチャットから mcp-rs を使う手順を、README とウェブサイトのガイドに追加しました。登録には copilot mcp add を使います。認証情報は、v0.24.0 で加えた OS の資格情報ストアから読み込むので、Copilot の設定にパスワードを書く必要はありません。Claude で使っている認証情報を、そのまま使えます。

修正

  • 接続の確認を誰でも通るように:wordpress_health_check と mcp-rs check は、サイトに到達できるかを、認証の要らない /wp-json/ で確かめるようにしました。これまでは管理者だけが読める設定を読んでいたため、投稿者や寄稿者のアカウントでは「到達できない」と誤って報告していました

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

  • 設定ファイルとツール:互換性のない変更はありません。v0.24.0 の設定のまま使えます
  • ソースからビルドしている場合:mysql-backend が既定の機能になりました。--no-default-features を付けてビルドすると、MySQL と MariaDB への対応は含まれません

mcp-rs をはじめる

必要なのは、アプリケーションパスワードを発行した WordPress サイトです。リリースのページから、お使いの環境のバイナリをダウンロードします。

設定ファイルに keyring を書き、認証情報を OS の資格情報ストアに保存して、設定を確かめます。

mcp-rs wordpress-keyring set my-site
mcp-rs checkCode language: Bash (bash)

問題が無ければ、mcp-rs を絶対パスで Claude Code に登録します。

claude mcp add mcp-rs --scope user \
  -- /path/to/mcp-rs --config /path/to/mcp-config.tomlCode language: Bash (bash)

登録したら、AI に「mcp-rs の状態を確かめて」と頼んでみてください。mcp_rs_status で、バージョンや WordPress への接続の状態を確かめられます。資格情報ストアの使い方は、v0.24.0 の記事で紹介しています。

さいごに

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

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

mcp-rs v0.25.0 を GitHub で見る

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

Optimole による最適化