ファイルコンテキストサーバー

大規模言語モデル（LLM）にファイルシステムコンテキストを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、LLMは高度なキャッシュ機能とリアルタイムファイル監視機能を利用して、コードファイルの読み取り、検索、分析を行うことができます。

特徴

• ファイル操作
  • ファイルとディレクトリの内容を読み取る
  • 詳細なメタデータを含むファイルを一覧表示する
  • リアルタイムのファイル監視とキャッシュ無効化
  • 複数のファイルエンコーディングのサポート
  • 再帰的なディレクトリトラバーサル
  • ファイルタイプのフィルタリング
• コード分析
  • 循環的複雑度の計算
  • 依存関係の抽出
  • コメント分析
  • 品質指標:
    • 重複行の検出
    • 長い行の検出（100文字以上）
    • 複雑な機能の識別
    • 行数（合計、空でない行、コメント）
• スマートキャッシング
  • LRU（最長時間未使用）キャッシュ戦略
  • ファイル変更時の自動キャッシュ無効化
  • 設定可能な制限を備えたサイズを考慮したキャッシュ
  • キャッシュ統計とパフォーマンスメトリック
  • 効率的な検索のための最終読み取り結果のキャッシュ
• 詳細検索
  • 正規表現パターンマッチング
  • 設定可能な周囲の線によるコンテキスト認識結果
  • ファイルタイプのフィルタリング
  • マルチパターン検索のサポート
  • キャッシュされた結果の検索
  • 除外パターン

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop の File Context Server を自動的にインストールするには:

手動インストール

使用法

サーバーの起動

利用可能なツール

1. リストコンテキストファイル
   • 詳細なメタデータを含むディレクトリ内のファイルを一覧表示します
   { "path": "./src", "recursive": true, "includeHidden": false }
2. 読み取りコンテキスト
   • メタデータを含むファイルまたはディレクトリの内容を読み取ります
   { "path": "./src/index.ts", "encoding": "utf8", "maxSize": 1000000, "recursive": true, "fileTypes": ["ts", "js"] }
3. 検索コンテキスト
   • コンテキストを使用してファイル内のパターンを検索します
   { "pattern": "function.*", "path": "./src", "options": { "recursive": true, "contextLines": 2, "fileTypes": ["ts"] } }
4. コードを分析する
   • コードファイルを分析して品質メトリクスを算出します
   { "path": "./src", "recursive": true, "metrics": ["complexity", "dependencies", "quality"] }
5. キャッシュ統計
   • キャッシュ統計とパフォーマンスメトリックを取得します
   { "detailed": true }

エラー処理

サーバーは、具体的なエラー コードとともに詳細なエラー メッセージを提供します。

• FILE_NOT_FOUND : ファイルまたはディレクトリが存在しません
• PERMISSION_DENIED : アクセス権限の問題
• INVALID_PATH : 無効なファイルパス形式
• FILE_TOO_LARGE : ファイルのサイズ制限を超えています
• ENCODING_ERROR : ファイルのエンコードの問題
• UNKNOWN_ERROR : 予期しないエラー

構成

カスタマイズ用の環境変数:

• MAX_CACHE_SIZE : キャッシュされるエントリの最大数（デフォルト: 1000）
• CACHE_TTL : キャッシュの有効期間（ミリ秒）（デフォルト: 1時間）
• MAX_FILE_SIZE : 読み取り時の最大ファイルサイズ（バイト単位）

発達

ライセンス

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

貢献

貢献を歓迎します！行動規範とプルリクエストの送信手順の詳細については、貢献ガイドをお読みください。