Modern Cli MCP

🚀 モダンCLI MCPサーバー

このサーバーは、AI/LLMエージェントに対して107のモダンCLIツールを提供します。ファイルシステム、Gitフォージ、コンテナ、Kubernetes、データ変換ツールなどへの構造化されたJSON - RPCアクセスを提供し、JSON出力によりAI消費に最適化されています。

ドキュメント · ツール

✨ 主な機能

• 15グループの107ツール：ファイルシステム、検索、Git（GitHub/GitLab）、コンテナ、Kubernetes、データ処理
• AI最適化出力：構造化解析用にデフォルトでJSON形式
• アクセス制御：.agentignoreファイルでAIエージェントがアクセスできるファイルを制御
• ゼロコンフィグ：Nixがすべての依存関係をバンドルするため、手動でのツールインストール不要

🚀 クイックスタート

Claude Desktop / Claude Code

MCP設定に追加します。

オプション1: Nix（推奨）

{
  "mcpServers": {
    "modern-cli": {
      "command": "nix",
      "args": ["run", "github:NacoSolutions/modern-cli-mcp", "--"]
    }
  }
}

オプション2: Docker

{
  "mcpServers": {
    "modern-cli": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/nacosolutions/modern-cli-mcp"]
    }
  }
}

オプション3: バイナリ

{
  "mcpServers": {
    "modern-cli": {
      "command": "/path/to/modern-cli-mcp"
    }
  }
}

💻 使用例

利用可能なツール (70+)

ファイルシステム

検索

Gitフォージ

コンテナ

Kubernetes

データ変換

ネットワーク

システム

Diff/Git

ユーティリティ

📦 インストール

Nix with Flakes（推奨）

FlakesはDeterminate Nixでデフォルトで有効になっています。標準のNixの場合は、--experimental-features 'nix-command flakes'で有効にするか、~/.config/nix/nix.confに追加します。

experimental-features = nix-command flakes

直接実行（インストール不要）

nix run github:NacoSolutions/modern-cli-mcp

プロファイルにインストール

nix profile install github:NacoSolutions/modern-cli-mcp

flake.nixに追加

{
  inputs.modern-cli-mcp.url = "github:NacoSolutions/modern-cli-mcp";

  # outputsで使用
  outputs = { self, nixpkgs, modern-cli-mcp }: {
    # packages、devShellsなどに追加
  };
}

Nix with FlakeHub

FlakeHubは、セマンティックバージョニングを持つバージョン付きのflake参照を提供します。

CLIを介してflake.nixに追加

fh add NacoSolutions/modern-cli-mcp

または手動で

{
  inputs.modern-cli-mcp.url = "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/*.tar.gz";
}

特定のバージョンを実行

nix run "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/0.2.tar.gz"

Nix without Flakes（クラシック）

Flakesが有効になっていないNixインストールの場合、リポジトリにはflake-compatを介してdefault.nixが含まれています。

ターボールからビルド

nix-build https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default
./result/bin/modern-cli-mcp

またはクローンしてローカルでビルド

git clone https://github.com/NacoSolutions/modern-cli-mcp
cd modern-cli-mcp
nix-build
./result/bin/modern-cli-mcp

プロファイルにインストール

nix-env -if https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default

Docker

docker pull ghcr.io/nacosolutions/modern-cli-mcp
docker run --rm -i ghcr.io/nacosolutions/modern-cli-mcp

ソースから（Cargo）

CLIツールを別途PATHにインストールする必要があります。

cargo install --git https://github.com/NacoSolutions/modern-cli-mcp

開発

Nixを使用する場合（推奨）

# 開発シェルに入る
nix develop

# 利用可能なコマンド（全リストを表示するには'menu'を実行）
build         # リリースバイナリをビルド
run           # サーバーを実行
test          # テストを実行
check         # Cargo check
clippy        # clippyでリント
fmt           # コードをフォーマット
flake-check   # Nix flakeチェック

Nixを使用しない場合

# RustツールチェーンとCLIツールを別途インストールする必要があります
cargo build --release
cargo run
cargo test

🔧 技術詳細

アーキテクチャ

src/
├── main.rs           # エントリポイント、MCPサーバーのセットアップ
└── tools/
    ├── mod.rs        # ツールの登録とルーティング
    └── executor.rs   # ツールの実行ロジック

サーバーはCLIツールを構造化されたJSON入出力でラップします。各ツールは以下の手順で動作します。

1. JSONスキーマを介してパラメータを検証
2. 適切なコマンドを構築
3. 実行して出力をキャプチャ
4. 構造化された結果を返す

コンフィグレーション

NixパッケージはすべてのCLIツールをバンドルしています。cargoを介して実行する場合は、ツールがPATHにあることを確認してください。

環境変数

• RUST_LOG - ログレベル（デフォルト: info）

.agentignore

.agentignoreファイルを使用して、AIエージェントがアクセスできるファイルを制御します。gitignore構文を使用しますが、独立して動作します。ツールは.agentignoreのみを尊重し、.gitignoreは尊重しません。

パターンソース（優先順位順）

1. ~/.config/agent/ignore - すべてのプロジェクトのグローバルパターン
2. .agentignore - ディレクトリごとのパターン（作業ディレクトリから上方向に探索）

.agentignoreの例

# シークレットと資格情報
*.secret
.env*
secrets/
credentials.json

# 大きな生成ファイル
node_modules/
target/
*.min.js

# 機密データ
*.pem
*.key

動作

• ブロックされたパスはエラーを返します: Path is blocked by .agentignore: /path/to/file
• 検索ツール（fd、rg、ast-grep）は自動的に無視パターンを適用します
• 子ディレクトリのパターンは、親パターンを拡張（置き換えではない）します

📄 ライセンス

MIT