ファイルシステムMCPサーバー

標準化されたツールインターフェイスを通じてファイルシステムの操作、分析、および操作機能を提供するモデルコンテキストプロトコル (MCP) サーバー実装。

建築

サーバーは MCP SDK 上に構築され、明確なレイヤーに編成されています。

コンポーネント

サーバー層: MCPプロトコル通信とツールディスパッチを処理する
ツールレジストリ: ツールの登録と実行を管理します
運用層: コア機能を実装する
ファイルシステムインターフェース:安全なファイルシステムアクセスを提供する

インストール

リポジトリをクローンします。

git clone <repository-url>
cd filesystem-server

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

MCP 設定を構成します (cline_mcp_settings.json):

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["path/to/filesystem-server/build/index.js"]
    }
  }
}

ツールリファレンス

ディレクトリ操作

リストディレクトリ

メタデータとともにディレクトリの内容を一覧表示します。

interface ListDirectoryParams {
    path: string;       // Directory path
    recursive?: boolean; // List recursively (default: false)
}

interface ListDirectoryResult {
    entries: {
        name: string;
        path: string;
        isDirectory: boolean;
        size: number;
        created: string;
        modified: string;
        accessed: string;
        mode: string;
    }[];
}

ディレクトリの作成

新しいディレクトリを作成します。

interface CreateDirectoryParams {
    path: string;       // Directory path
    recursive?: boolean; // Create parent directories (default: true)
}

ファイル操作

読み取りファイル

エンコードサポートを使用してファイルの内容を読み取ります。

interface ReadFileParams {
    path: string;     // File path
    encoding?: string; // File encoding (default: 'utf8')
}

書き込みファイル

コンテンツをファイルに書き込みます。

interface WriteFileParams {
    path: string;     // File path
    content: string;  // Content to write
    encoding?: string; // File encoding (default: 'utf8')
}

ファイル追加

ファイルにコンテンツを追加します。

interface AppendFileParams {
    path: string;     // File path
    content: string;  // Content to append
    encoding?: string; // File encoding (default: 'utf8')
}

分析操作

テキスト分析

テキストファイルのプロパティを分析します。

interface AnalyzeTextParams {
    path: string; // File path
}

interface AnalyzeTextResult {
    lineCount: number;
    wordCount: number;
    charCount: number;
    encoding: string;
    mimeType: string;
}

ハッシュを計算する

指定されたアルゴリズムを使用してファイルハッシュを計算します。

interface CalculateHashParams {
    path: string;           // File path
    algorithm?: 'md5' | 'sha1' | 'sha256' | 'sha512'; // Hash algorithm
}

interface CalculateHashResult {
    hash: string;
    algorithm: string;
}

重複を見つける

ディレクトリ内の重複ファイルを識別します。

interface FindDuplicatesParams {
    path: string; // Directory path
}

interface FindDuplicatesResult {
    duplicates: {
        hash: string;
        size: number;
        files: string[];
    }[];
}

圧縮操作

作成_zip

ZIP アーカイブを作成します。

interface CreateZipParams {
    files: string[];  // Files to include
    output: string;   // Output ZIP path
}

抽出_zip

ZIP アーカイブを抽出します。

interface ExtractZipParams {
    path: string;    // ZIP file path
    output: string;  // Output directory
}

エラー処理

サーバーは標準の MCP エラーコードを使用します。

enum ErrorCode {
    ParseError = -32700,
    InvalidRequest = -32600,
    MethodNotFound = -32601,
    InvalidParams = -32602,
    InternalError = -32603
}

エラー応答には次のものがあります:

エラーコード
人間が読めるメッセージ
利用可能な場合の追加コンテキスト

エラー例:

{
    "code": -32602,
    "message": "File not found: /path/to/file.txt"
}

発達

プロジェクト構造

src/
├── operations/     # Core operations implementation
├── tools/         # MCP tool definitions and handlers
├── __tests__/     # Test suites
├── index.ts       # Entry point
├── server.ts      # MCP server setup
├── types.ts       # Type definitions
└── utils.ts       # Utility functions

テストの実行

テストスイートを実行します。

npm test

カバレッジ付きで実行:

npm run test:coverage

開発モード

ウォッチモードで実行:

npm run watch

コード品質

コードベースをリントする:

npm run lint

型チェック:

npm run type-check

依存関係

コア依存関係:

@modelcontextprotocol/sdk: MCP サーバーの実装
ファイルタイプ: ファイルタイプの検出
mime-types: MIMEタイプの検索
crypto-js: ファイルハッシュ
アーカイバ：ZIP作成
extract-zip: ZIP抽出
iconv-lite: テキストエンコーディング
chardet: エンコーディング検出

開発依存関係:

Typescript: 型システム
jest: テスト
eslint: リンティング
prettier: フォーマット
ts-node: TypeScriptの実行
nodemon: 開発サーバー

貢献

リポジトリをフォークする
機能ブランチを作成する
新機能のテストを書く
すべてのテストに合格することを確認する
プルリクエストを送信する

ライセンス

マサチューセッツ工科大学

Filesystem MCP Server

Integrations