Releases: YujiSuzuki/hostmcp
Release list
v0.5.0 — Client URL Auto-Resolution & Prebuilt Binaries
Makes hostmcp client commands work out of the box without manually specifying a port, and turns on the prebuilt binary install instructions that were previously marked "coming soon".
Features
- 🔌 Client URL auto-resolution —
hostmcp clientcommands now fall back toserver.portin the workspace'shostmcp.yamlwhen neither--urlnorHOSTMCP_SERVER_URLis set, so you no longer need to pass the port manually; the resolved config path is logged to stderr so an unexpected port stays traceable
Documentation
- 📦 Prebuilt binaries — Enabled the "Prebuilt Binary (no Go required)" install instructions in
README.md/README.ja.md, previously commented out as "coming soon"
Full Changelog: v0.4.0...v0.5.0
v0.5.0 — クライアントのURL自動解決とビルド済みバイナリ
hostmcp client コマンドをポートを手動指定せずにそのまま使えるようにし、これまで「近日公開予定」としてコメントアウトされていたビルド済みバイナリの導入手順を有効化しました。
主な機能
- 🔌 クライアントURLの自動解決 —
--urlとHOSTMCP_SERVER_URLがどちらも未設定の場合、ワークスペースのhostmcp.yamlのserver.portから自動でサーバーURLを解決するようにし、ポートの手動指定が不要に。想定外のポートが無警告で使われないよう、解決したconfigパスをstderrに出力
ドキュメント
- 📦 ビルド済みバイナリ —
README.md/README.ja.mdで「近日公開予定」としてコメントアウトされていた「ビルド済みバイナリ(Go不要)」の導入手順を有効化
Full Changelog: v0.4.0...v0.5.0
v0.4.0 — Audit Logging & Workspace Flexibility
Adds audit logging, more flexible workspace/config resolution, and self-describing MCP capability info — plus a documentation pass covering previously undocumented CLI commands and config keys.
Features
- 📝 Audit logging — Record security-relevant events (tool calls, access denials, client connections) as structured JSON, with log rotation on startup
- 🧭
--workspace-rootflag — Overrideworkspace_rootindependently of--config, so the samehostmcp.yamlcan be reused across workspaces;--configand--workspaceare now mutually exclusive to avoid pointing them at different projects unintentionally - 🤖 Self-describing MCP instructions — The
initializeresponse now summarizes live host tool status (enabled, newly staged, or changed-since-approval) instead of relying on a static tool list - 📚 Expanded documentation — Current container commands (
hostmcp use), host tools management (hostmcp tools sync/list,serve --sync/--dev),--allow-exec,--host-dangerously, logging flags, audit config, and the Gemini Code Assist exclusion-file import are now documented - 🔧 Build fix — Release binaries now embed the correct version tag instead of falling back to a commit SHA
Fixes
- Correct version resolution for
go installusers (falls back to build info instead of showing "dev")
Full Changelog: v0.3.0...v0.4.0
v0.4.0 — 監査ログとワークスペースの柔軟性
監査ログ、より柔軟なワークスペース/設定解決、自己記述的なMCP機能情報を追加。加えて、これまで未文書化だったCLIコマンドと設定キーのドキュメント整備も行いました。
主な機能
- 📝 監査ログ — セキュリティ関連イベント(ツール呼び出し、アクセス拒否、クライアント接続)を構造化JSONとして記録し、起動時にログローテーションを実行
- 🧭
--workspace-rootフラグ —--configとは独立してworkspace_rootを上書き可能にし、同じhostmcp.yamlを複数ワークスペースで使い回せるように。--configと--workspaceは併用不可にし、意図せず別プロジェクトを指す事故を防止 - 🤖 自己記述的なMCP instructions —
initializeレスポンスが、静的なツール一覧に頼らず、ホストツールの最新状態(有効化済み・新規ステージング・承認後変更あり)を動的に要約 - 📚 ドキュメント拡充 — カレントコンテナコマンド(
hostmcp use)、ホストツール管理(hostmcp tools sync/list、serve --sync/--dev)、--allow-exec、--host-dangerously、ロギングフラグ、監査ログ設定、Gemini Code Assist除外ファイルのインポート例を文書化 - 🔧 ビルド修正 — リリースバイナリに正しいバージョンタグが埋め込まれるように修正(コミットSHAへのフォールバックを回避)
修正
go installユーザーのバージョン解決を修正("dev" 表示ではなくビルド情報にフォールバック)
Full Changelog: v0.3.0...v0.4.0
v0.3.0
v0.3.0 — First Stable Release
First stable release of HostMCP — successor to DockMCP.
HostMCP is an MCP server that runs on the host OS, giving AI assistants (Claude Code, Gemini Code Assist, etc.) inside an AI Sandbox controlled access to the host environment — Docker containers, host tools, and host OS commands — through configurable security policies.
Features
- 🐳 Docker container access — Logs, exec, inspect, stats, lifecycle (start/stop/restart)
- 🔧 Host tool execution — Run approved scripts in
.sandbox/host-tools/with a human approval workflow - 💻 Host OS commands — Execute whitelisted CLI commands on the host OS
- 🔒 Security-first design — Whitelist-based access control, output masking, blocked paths
- 🤖 Multi-AI support — Works with Claude Code and Gemini Code Assist
- 🚀 Zero dependencies — Single binary, no runtime requirements
- 🌐 Cross-platform — Windows, macOS (Intel & Apple Silicon), Linux
Installation
go install github.com/YujiSuzuki/hostmcp@latestOr download the binary for your platform from the assets below.
Full Changelog: https://github.com/YujiSuzuki/hostmcp/commits/v0.3.0
v0.3.0 — 初の安定版リリース
HostMCP 初の安定版リリース — DockMCP の後継。
HostMCP は、ホスト OS 上で動作する MCP サーバーです。AI Sandbox 内の AI アシスタントが、セキュリティポリシーに基づいてホスト環境(Docker コンテナ・ホストツール・ホスト OS コマンド)に安全にアクセスできるようにします。
主な機能
- 🐳 Docker コンテナアクセス — ログ・exec・inspect・stats・ライフサイクル管理(start/stop/restart)
- 🔧 ホストツール実行 —
.sandbox/host-tools/の承認済みスクリプトを人間の承認フローで実行 - 💻 ホスト OS コマンド — ホワイトリストに登録された CLI コマンドをホスト OS 上で実行
- 🔒 セキュリティファースト設計 — ホワイトリスト制アクセス制御・出力マスキング・パスブロック
- 🤖 マルチ AI 対応 — Claude Code・Gemini Code Assist に対応
- 🚀 ゼロ依存 — シングルバイナリ、ランタイム不要
- 🌐 クロスプラットフォーム — Windows・macOS(Intel & Apple Silicon)・Linux
インストール
go install github.com/YujiSuzuki/hostmcp@latestまたは、以下のアセットからお使いのプラットフォーム用のバイナリをダウンロードしてください。
Full Changelog: https://github.com/YujiSuzuki/hostmcp/commits/v0.3.0