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

mcp-rs v0.23.0公開:PostgreSQLのデータベースツールとDockerイメージ

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

2026年11月12日に、v0.23.0 を公開しました。今回の柱は2つです。1つは、PostgreSQL のデータベースを AI から安全に調べられるツールです。もう1つは、そのまま起動できるようになった Docker のイメージです。あわせて、ドキュメントとコードを、実際の機能に合わせて大きく整理しました。この記事では、v0.23.0 の更新内容と、前回の記事(v0.18.4)以降の主な更新を紹介します。

v0.23.0 のポイント

分野内容
データベースPostgreSQL に接続し、AI から SELECT やテーブルの構造の確認ができる。書き込みは明示的に許可したときだけ
Dockerイメージが既定の設定で起動するように修正。STDIO・HTTP の両方の使い方を整理
ドキュメントREADME とウェブサイトを、実際の機能に合わせて書き直し
コード使われていないコードや、効いていなかった設定を削除

PostgreSQL のデータベースツール

設定ファイルに [database] の接続先を書くと、AI から PostgreSQL を調べるツールが使えるようになりました。「先月の注文を集計して」「このテーブルにはどんな列がある?」と頼むと、AI が SQL を組み立てて実行し、結果をもとに答えます。

ツールできること使えるとき
execute_querySELECT の実行(パラメーター付き)常に
get_schemaテーブルと列の構造の取得常に
execute_commandINSERT・UPDATE・DELETE を1つずつ実行allow_write = true のときだけ

設定は次のとおりです。パスワードは ${MCP_DB_PASSWORD} のように環境変数で渡せます。

[database]
engine = "postgresql"
host = "localhost"
port = 5432
database = "app"
username = "mcp_reader"
password = "${MCP_DB_PASSWORD}"
ssl_mode = "prefer"

allow_write = false          # true で execute_command も使える
max_rows = 1000              # execute_query が返す行数の上限
query_timeout_seconds = 30   # 1つの SQL の時間の上限
max_connections = 5Code language: PHP (php)

データベースの機能は、既定のビルド(cargo build --release)と Docker のイメージに含まれています。[database] を書かなければ、これまでどおり WordPress だけで動きます。

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

  • 読み取りは本当に読み取りだけ:execute_query は、毎回、読み取り専用のトランザクションの中で実行してからロールバックします。WITH の中に書き込みを隠した SQL や、データを書き換える関数を呼ぶ SELECT も、データベースが拒否します
  • 書き込みは明示した場合だけ:execute_command は、allow_write = true のときだけ AI に見えます。受け付けるのは1つの INSERT・UPDATE・DELETE だけで、テーブルの作成・削除や権限の変更などは拒否します
  • 値は SQL に埋め込まない:パラメーターは SQL の文字列に埋め込まず、データベースに別に渡します。日付・UUID・数値などは、PostgreSQL が期待する型に合わせて送ります。形式を変換できない型は、別の値として保存してしまわないよう、送らずにキャストの書き方を案内します
  • 上限を設ける:1つの SQL の時間(既定30秒)と、返す行数(既定1000行)に上限があります。上限を超えた結果は、切り詰めたことが AI に分かる形で返します
  • パスワードを表に出さない:パスワードは、ログ・状態の表示・エラーの文に出しません。環境変数が無い場合は、データベースの機能だけを止め、WordPress のツールはそのまま使えます
  • 監査ログに記録:ツールの呼び出しは、SQL と結果を監査ログに記録します。パラメーターの値は記録しません

そのうえで、mcp-rs には読み取り専用のロールで接続することをおすすめします。読み取り専用のトランザクションでも、dblink などの拡張が別の接続で書き込むことは防げないためです。ロールの作り方は、データベースのドキュメントをご覧ください。

Docker のイメージ

以前の Docker のイメージは、既定の引数が存在しないオプションになっていて、起動してもすぐに終了していました。v0.23.0 では、設定ファイルをマウントするだけで起動するように直し、イメージの起動と MCP の応答を CI で確かめるようにしました。イメージは GitHub Container Registry で公開しています。

docker pull ghcr.io/n-takatsu/mcp-rs:0.23

Claude Code から使う場合は、設定ファイルのフォルダを /app/config にマウントして登録します。設定ファイルの名前は mcp-config.toml にします。

claude mcp add mcp-rs --scope user \
  -e WORDPRESS_PASSWORD="your application password" \
  -- docker run -i --rm -v /path/to/config:/app/config:ro \
     -e WORDPRESS_PASSWORD ghcr.io/n-takatsu/mcp-rs:0.23Code language: JavaScript (javascript)
  • 小さく安全なイメージ:シェルを含まない distroless のイメージで、root ではないユーザーで動きます
  • HTTP モードと Docker Compose:docker-compose.yml は、HTTP モード(ポート8081)で、ルートのファイルシステムを読み取り専用にして動かします。ログと監査ログは名前付きボリュームに残るので、コンテナを作り直しても消えません

詳しい使い方は、Docker のガイドをご覧ください。

実際の機能に合わせた整理

mcp-rs には、開発の途中で作ったまま本体とつながっていない機能や、実態より大きく見える説明が残っていました。v0.23.0 では、書いてあることと実際にできることを一致させることを優先しました。

  • ドキュメントの書き直し:README とウェブサイトから、実態と合わない表現や、存在しない機能の説明を除きました。データベースのドキュメントも、実際の設定の書き方と安全のための仕組みに合わせて書き直しました
  • 使われていないコードの削除:ビルドされない古いコードや、WordPress につながずに成功を表示するだけだったサンプルを削除しました。コンパイラーの「使われていない」という警告も、CI でエラーとして扱うようにしました
  • 効いていなかった設定の削除:受け取っても使っていなかった引数や、何もせずに成功を返すだけだった機能を削除しました。効いているように見えて実際には効いていなかったもので、動作は変わりません

v0.19〜v0.22 の主な更新

前回の記事(v0.18.4)から v0.23.0 までの間にも、運用と安全性を中心に更新を重ねてきました。

バージョン主な内容
v0.19.0監査ログに呼び出し元と結果を記録。HTTP モードで、API キーごとに使えるツールを制限
v0.19.1--version と --help
v0.19.2mcp-rs 自身の状態(バージョン・設定ファイル・ログの場所・各機能の状態)を AI が確かめられるツール mcp_rs_status
v0.20.0本体から使われていないモジュール(約6.1万行)を削除。設定ファイルの環境変数の展開を修正
v0.21.0監査ログの各記録に、記録したプロセスの番号を追加
v0.22.0MCP のプロトコルの最新版(2025-11-25)に対応。HTTP モードでブラウザーからの不正なリクエストを拒否。監査ログの既定の保存先を変更

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

  • 監査ログの保存先(v0.22.0):既定の保存先が、Windows では %USERPROFILE%\.mcp-rs\audit\audit.log になりました。保存先を設定ファイルで指定している場合は、そのままです
  • 起動時の引数(v0.19.2):知らない引数や、パスの無い --config を指定すると、起動しないようになりました。登録しているコマンドを確かめてください
  • Docker のイメージ(v0.23.0):設定ファイルを /app/config/mcp-config.toml にマウントして使います
  • Rust のライブラリとして使っている場合:v0.23.0 で、使われていなかった引数の削除などにより、いくつかの API が変わりました。MySQL のエンジンは既定のビルドに含まれなくなったので、--features mysql-backend を指定してください。詳しくは CHANGELOG をご確認ください

mcp-rs をはじめる

必要なのは、Rust 1.88 以降の環境と、アプリケーションパスワードを発行した WordPress サイトです。ソースを取得してビルドします。

git clone --branch v0.23.0 https://github.com/n-takatsu/mcp-rs.git
cd mcp-rs
cargo build --releaseCode language: PHP (php)

ビルドした mcp-rs を、絶対パスで Claude Code に登録します。WordPress の接続情報は、環境変数から読み込みます。

claude mcp add mcp-rs --scope user \
  -e WORDPRESS_URL=https://your-wordpress-site.com \
  -e WORDPRESS_USERNAME=your_username \
  -e WORDPRESS_PASSWORD="your application password" \
  -- /path/to/mcp-rs/target/release/mcp-rs --config /path/to/mcp-rs/configs/production/claude-desktop.tomlCode language: JavaScript (javascript)

登録したら、AI に「mcp-rs の状態を確かめて」と頼んでみてください。mcp_rs_status で、バージョンや WordPress への接続の状態を確かめられます。詳しくは Claude Code 統合ガイドと Claude Desktop 連携ガイドをご覧ください。

さいごに

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

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

mcp-rs v0.23.0 を GitHub で見る

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

Optimole による最適化