付録: MCP で Senu を使う (任意)
約 2 分で読めます
MCP (Model Context Protocol) は、AI の道具がほかのプログラムの関数を呼ぶための決まりです。Senu はプロジェクト一覧を、list_projects という一つの MCP の道具として提供できます。やり取りは stdio で行います。つまり AI の道具が Senu を自分で起動し、ネットワークのポートではなく Senu の入力と出力を通して話します。この動き方は、頼まない限り無効です。
動いている Senu があれば Ctrl+C で止めてください。追加の指定がないと、Senu は断ります。
cargo run --quiet -- mcp
senu: MCP is off by default; start it with `senu mcp --enable-mcp`
MCP は既定で無効なので senu mcp --enable-mcp で起動するように、という意味です。スクリプト scripts/check_mcp.py は AI の道具の役をします。Senu を MCP モードで起動し、MCP の initialize メッセージでやり取りを始め、tools/call で list_projects を呼んで答えを表示します。Python 3 が必要です。MCP モードは起動の前にトークンも必要とし、ここではデモ用の値を使います。トークンは起動時の設定にすぎません。stdio では、Senu は自分を起動したローカルのプログラムを信頼しており、トークンは離れた相手を認証しません。
SENU_MCP_TOKEN=demo-mcp-token python3 scripts/check_mcp.py ./target/debug/senu mcp --enable-mcp
{"jsonrpc":"2.0","id":2,"result":{"content":[{"type":"text","text":"{\"projects\":[{\"id\":\"acme-001\",\"name\":\"Artemis Launch\"},{\"id\":\"acme-003\",\"name\":\"<script>alert('x')</script> & \\\"Launch\\\" Notes\"}]}"}],"structuredContent":{"projects":[{"id":"acme-001","name":"Artemis Launch"},{"id":"acme-003","name":"<script>alert('x')</script> & \"Launch\" Notes"}]},"isError":false}}
./target/debug/senu は cargo run がビルドしたプログラムです。前の付録でプロジェクトの名前を変えていれば、答えには Artemis Launch と出ます。Web ページも JSON も MCP も、同じ関数を通して同じ一覧を読んでいるからです。
演習
同じコマンドを SENU_MCP_TOKEN=demo-mcp-token なしで実行してください。何が起きるでしょう。それはなぜ役に立つのでしょう。
解答. Senu は入力を読む前に止まり、SENU_MCP_TOKEN が設定されていないと伝えます。トークンを渡されていない道具が、うっかり Senu を起動することはありません。確認用のスクリプトは、Senu が終了したと報告します。