Rust MCP Filesystem

Rust MCP Filesystem

Rust MCP Filesystem は、さまざまなファイルシステム操作を効率的に処理するために設計された、高速で非同期かつ軽量な MCP（Model Context Protocol）サーバーです。 このプロジェクトは、JavaScript ベースの @modelcontextprotocol/server-filesystem を純粋な Rust で書き直したもので、最新のファイルシステム操作に適した機能の強化、パフォーマンスの向上、堅牢な機能セットを提供します。

📝 インストールと設定の手順については、プロジェクトのドキュメントを参照してください。

⭐️ Docker Hub の MCP Registryでも利用できます：https://hub.docker.com/mcp/server/rust-mcp-filesystem

機能

• ⚡ 高パフォーマンス：高速性と効率性を実現するために Rust で構築されており、非同期 I/O を活用してファイルシステム操作をシームレスに処理します。
• 🔒 デフォルトで読み取り専用：書き込みアクセスなしで起動するため、明示的に設定を変更するまで安全性が保たれます。
• 🔍 高度な Glob 検索：Glob パターンの完全一致に対応し、標準的な Glob 構文を使ってファイルやディレクトリを正確に絞り込めます。たとえば、*.rs、src/**/*.txt、logs/error-???.log などのパターンを使用して、特定のファイルタイプや再帰的なディレクトリ検索、パターンに一致するファイル名を対象にできます。
• 🔄 MCP Roots に対応：クライアントが許可されたディレクトリの一覧を動的に変更できます（デフォルトでは無効です）。
• 📦 ZIP アーカイブに対応：ファイルやディレクトリから ZIP アーカイブを作成したり、ZIP ファイルを簡単に展開したりするツールを備えています。
• 🪶 軽量：外部依存関係がなく（Node.js、Python などは不要です）、単一のバイナリにコンパイルされ、リソースの使用量も最小限です。軽量なデプロイから大規模なデプロイまで、幅広い用途に適しています。
• 🎛️ ツールの無効化：特定のツールを無効にして機能を制限し、利用可能なツールの数を減らすことで、トークンの節約に役立ちます。

👉 ツールとその他の機能の全一覧については、機能を参照してください。

🔧 インストールと設定

詳しいセットアップ手順については、プロジェクトのドキュメントをご覧ください。

クイックインストールガイド

• シェルスクリプト

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.4.5/rust-mcp-filesystem-installer.sh | sh

• PowerShell スクリプト

powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.4.5/rust-mcp-filesystem-installer.ps1 | iex"

• Homebrew

brew install rust-mcp-stack/tap/rust-mcp-filesystem

Cargo

cargo install rust-mcp-filesystem --locked

• NPM

npm i -g @rustmcp/rust-mcp-filesystem@latest

npm パッケージは利便性のために提供されています。同じ Rust バイナリを実行しますが、標準的な npm パッケージとしてインストールして使用できます。

• Docker

  https://hub.docker.com/mcp/server/rust-mcp-filesystem

• バイナリをダウンロード

  https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/tag/v0.4.5

目的

このプロジェクトは、ファイルシステム管理のための信頼性と安全性に優れ、豊富な機能を備えた MCP サーバーを提供することを目指しています。より高いパフォーマンスと型安全性を備えた言語を用いて、@modelcontextprotocol/server-filesystem の機能を再構築します。ファイルの調査、自動化、システム統合のためのツールを構築する場合、rust-mcp-filesystem は確かな基盤となります。

🧰 使用技術

このサーバーの構築には、rust-mcp-sdk と rust-mcp-schema を活用しています。Rust ベースの MCP プロジェクトを独自に作成したい方や、パフォーマンスと安全性を高めるために既存のプロジェクトを Rust に移行したい方は、ぜひこれらのリポジトリをご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

謝辞

@modelcontextprotocol/server-filesystem に着想を得て、Rust の力を活用して構築されました。