Bsmi021 MCP File Context Server

🚀 File Context Server

A Model Context Protocol (MCP) server that provides file system context for Large Language Models (LLMs). This server enables LLMs to read, search, and analyze code files, and features advanced caching and real-time file monitoring.

🚀 Quick Start

The File Context Server is a powerful tool that allows LLMs to interact with the file system. It offers a wide range of features for file operations, code analysis, and more.

✨ Features

File Operations

• Read file and directory contents.
• List files with detailed metadata.
• Real-time file monitoring and cache invalidation.
• Support for multiple file encodings.
• Recursive directory traversal.
• File type filtering.

Code Analysis

• Calculate cyclomatic complexity.
• Extract dependencies.
• Analyze comments.
• Quality metrics:
  • Detect duplicate lines.
  • Detect long lines (>100 characters).
  • Identify complex functions.
  • Count lines (total, non-empty, comment).

Intelligent Caching

• Least Recently Used (LRU) caching strategy.
• Automatic cache invalidation on file changes.
• Cache with size limit and configurable upper bound.
• Cache statistics and performance metrics.
• Cache recent read results to optimize searches.

Advanced Search

• Regular expression pattern matching.
• Results with configurable context lines.
• File type filtering.
• Support for multiple pattern searches.
• Search cached results.
• Exclusion patterns.

📦 Installation

npm install @modelcontextprotocol/file-context-server

💻 Usage Examples

Start the Server

npx file-context-server

Available Tools

list_context_files

• List files in a directory with detailed metadata.

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

read_context

• Read file or directory contents and metadata.

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

search_context

• Search for patterns in files and get context.

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

analyze_code

• Analyze code file quality metrics.

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

cache_stats

• Get cache statistics and performance metrics.

{
  "detailed": true
}

📚 Documentation

Error Handling

The server provides detailed error messages, including specific error codes:

• FILE_NOT_FOUND: File or directory does not exist.
• PERMISSION_DENIED: Access permission issue.
• INVALID_PATH: Invalid file path format.
• FILE_TOO_LARGE: File is too large.
• INTERNAL_ERROR: Internal server error.

Configuration

Configure the server using the following environment variables:

MAX_CACHE_SIZE=1000  # Set the maximum number of cache entries.
CACHE_EXPIRATION=3600  # Set the cache expiration time (in seconds).

Development

git clone [Repository URL]
cd file-context-server
npm install
npm start

📄 License

[License information to be filled in here]

🤝 Contribution Guidelines

[Contribution guidelines to be filled in here]