MCP File Context Server

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

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

🚀 クイックスタート

このファイルコンテキストサーバを使用することで、大型言語モデルにファイルシステムのコンテキストを提供し、コードファイルの操作や分析が可能になります。

✨ 主な機能

ファイル操作

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

コード分析

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

高度なキャッシュ

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

高度な検索

• 正規表現のマッチング
• コンテキストを考慮した結果で、コンテキスト行数を設定可能
• ファイルタイプのフィルタリング
• 複数のモードでの検索をサポートする
• キャッシュされた結果の検索
• 除外モード

📦 インストール

Smitheryを使用したインストール

Smithery を通じて、Claude Desktop用のFile Context Serverを自動的にインストールします。

npx -y @smithery/cli install @bsmi021/mcp-file-context-server --client claude

手動インストール

npm install @modelcontextprotocol/mcp-file-context

💻 使用例

サーバの起動

node index.js

利用可能なツール

• File Context Server: ファイルシステムのコンテキストサービスを提供します。
• Code Analysis Tools: コード分析機能をサポートします。

📚 ドキュメント

エラー処理

• エラーコード：500
  • 説明：サーバ内部エラー
  • 解決策：詳細情報を取得するためにログを確認してください
• エラーコード：404
  • 説明：リソースが見つかりません
  • 解決策：リクエストパスが正しいことを確認してください

設定

{
  "cache": {
    "enabled": true,
    "maxSize": 1000
  },
  "monitoring": {
    "enabled": true,
    "interval": 60000
  }
}

開発ガイド

開発サーバの起動

npm run dev

テスト

npm test

📄 ライセンス

MIT License

🔗 貢献ガイド

貢献を歓迎します！詳細は CONTRIBUTING.md を参照してください。

⚠️ 重要提示

クロスプラットフォームのパス互換性に関しては、globパターンの処理に path.posix.join を使用し、ファイルシステムへのアクセスに path.normalize を使用してください。この変更により、異なるオペレーティングシステムでのパス区切り文字とファイルマッチングの問題を回避できます。