Bsmi021 MCP File Context Server

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

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

✨ 主な機能

ファイル操作

• ファイルやディレクトリの内容を読み取る
• ファイルを一覧表示し、詳細なメタデータを提供する
• リアルタイムのファイル監視とキャッシュの無効化
• 複数のファイルエンコーディングをサポートする
• ディレクトリを再帰的に走査する
• ファイルタイプでのフィルタリングをサポートする

コード分析

• 循環的複雑度の計算
• 依存関係の抽出
• コメントの分析
• 品質指標：
  • 重複行の検出
  • 長い行（>100文字）の検出
  • 複雑な関数の識別
  • 行数の統計（合計、空でない行、コメント行）

スマートキャッシュ

• 最近最少使用（LRU）キャッシュ戦略
• ファイルが変更されたときに自動的にキャッシュを無効化する
• サイズ制限付きのキャッシュで、上限を設定可能
• キャッシュの統計とパフォーマンス指標
• 最近の読み取り結果をキャッシュして検索を最適化する

高度な検索

• 正規表現によるパターンマッチング
• コンテキスト行数を指定可能な結果
• ファイルタイプのフィルタリング
• 複数のパターンでの検索をサポートする
• キャッシュ結果の検索
• 除外パターンの指定

📦 インストール

npm install @modelcontextprotocol/file-context-server

💻 使用例

基本的な使用法

サーバーの起動

npx file-context-server

利用可能なツール

list_context_files

• ディレクトリ内のファイルとその詳細なメタデータを一覧表示する

{
  "path": "./src",
  "recursive": true,
  "includeHidden": false
}

read_context

• ファイルまたはディレクトリの内容とメタデータを読み取る

{
  "path": "./src/index.ts",
  "encoding": "utf8",
  "maxSize": 1000000,
  "recursive": true,
  "fileTypes": ["ts", "js"]
}

search_context

• ファイル内でパターンを検索し、コンテキストを取得する

{
  "pattern": "function.*",
  "path": "./src",
  "options": {
    "recursive": true,
    "contextLines": 2,
    "fileTypes": ["ts"]
  }
}

analyze_code

• コードファイルの品質指標を分析する

{
  "path": "./src",
  "recursive": true,
  "metrics": ["complexity", "dependencies", "quality"]
}

cache_stats

• キャッシュの統計情報とパフォーマンス指標を取得する

{
  "detailed": true
}

🔧 エラー処理

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

• FILE_NOT_FOUND：ファイルまたはディレクトリが存在しません
• PERMISSION_DENIED：アクセス権限に問題があります
• INVALID_PATH：無効なファイルパス形式です
• FILE_TOO_LARGE：ファイルが大きすぎます
• INTERNAL_ERROR：内部サーバーエラーです

🔧 設定

以下の環境変数を使用して設定を行います。

MAX_CACHE_SIZE=1000  # 最大キャッシュエントリ数を設定
CACHE_EXPIRATION=3600  # キャッシュの有効期限（秒）を設定

🔧 開発

git clone [リポジトリのURL]
cd ファイルコンテキストサーバー
npm install
npm start

📄 ライセンス

[ここにライセンス情報を記載]

🤝 貢献ガイド

[ここに貢献ガイドを記載]