docs: add URL support examples and update feature descriptions

Author: ctoth

CLAUDE.md

@@ -62,7 +62,8 @@ This is an MCP (Model Context Protocol) server that provides precise code extrac
 - **Data Models** (`models.py`) - Rich symbol representations with hierarchical relationships  
 - **Language Support** (`languages.py`) - Detection and mapping for 30+ programming languages
 - **Tree-sitter Queries** (`queries/`) - Language-specific syntax parsing patterns
-- **File Reading** (`file_reader.py`) - Unified file reading with VCS support
+- **File Reading** (`file_reader.py`) - Unified file reading with VCS and URL support
+- **URL Fetching** (`url_fetcher.py`) - HTTP fetching with caching and error handling
 - **VCS Support** (`vcs/`) - Pluggable version control system abstraction
 - **Entry Points** (`__main__.py`) - Module execution support
 
@@ -125,17 +126,42 @@ The server exposes 5 tools to AI assistants:
 
 **Best Practice**: Always use `get_symbols` first for code exploration, then use specific extraction tools for detailed analysis.
 
+### URL Support
+
+All 5 MCP tools support URLs for fetching remote code:
+
+**Examples:**
+```python
+# GitHub raw URLs
+get_symbols("https://raw.githubusercontent.com/user/repo/main/src/main.py")
+get_function("https://raw.githubusercontent.com/user/repo/main/src/api.py", "handle_request")
+
+# GitLab raw URLs  
+get_class("https://gitlab.com/user/project/-/raw/main/src/models.py", "User")
+get_lines("https://gitlab.com/user/project/-/raw/main/config.py", 10, 20)
+
+# Direct file URLs
+get_signature("https://example.com/code/utils.py", "helper_function")
+```
+
+**Features:**
+- Automatic content-type validation (text/* only)
+- File size limits (1MB default, configurable)
+- TTL caching for performance (5min default)
+- Robust error handling for network issues
+- Support for GitHub, GitLab, and direct file URLs
+
 ### Git Revision Support
 
-All 5 MCP tools now support an optional `git_revision` parameter for extracting code from any git revision:
+All 5 MCP tools also support an optional `git_revision` parameter for extracting code from any git revision:
 
 **Examples:**
 ```python
 # Extract from filesystem (default, backward compatible)
 get_symbols("src/main.py")
 get_function("src/main.py", "process_data")
 
-# Extract from git revisions
+# Extract from git revisions (NOT compatible with URLs)
 get_symbols("src/main.py", "HEAD~1")           # Previous commit
 get_function("src/main.py", "process_data", "feature-branch")  # Branch
 get_class("src/models.py", "User", "v1.0.0")   # Tagged version
@@ -156,4 +182,5 @@ get_signature("src/api.py", "handle_request", "HEAD^2")  # Merge parent
 - File must be in a git repository
 - Git command must be available in PATH
 - Revision must exist in the repository
-- File must exist at the specified revision
+- File must exist at the specified revision
+- **Note**: `git_revision` parameter is NOT supported when using URLs

README.md

@@ -18,7 +18,9 @@ MCP Server Code Extractor solves these problems by providing structured, tree-si
 - **🌍 30+ Languages**: Supports Python, JavaScript, TypeScript, Go, Rust, Java, C/C++, and many more
 - **📍 Line Numbers**: Every extraction includes precise line number information
 - **🔍 Code Discovery**: List all functions and classes in a file before extracting
-- **⚡ Fast & Lightweight**: Single-file implementation with minimal dependencies
+- **🌐 URL Support**: Fetch and extract code from GitHub, GitLab, and direct file URLs
+- **🔄 Git Integration**: Extract code from any git revision, branch, or tag
+- **⚡ Fast & Lightweight**: Efficient caching and minimal dependencies
 - **🤖 AI-Optimized**: Designed specifically for use with AI coding assistants
 
 ## Installation
@@ -141,7 +143,7 @@ Returns:
 
 ## Usage Examples
 
-### Example 1: Exploring a Python File
+### Example 1: Exploring Local Files
 
 ```python
 # First, see what's in the file
@@ -157,19 +159,35 @@ sig = get_signature("src/main.py", "process_data")
 # Returns: "def process_data(input_file: str, output_dir: Path) -> Dict[str, Any]:"
 ```
 
-### Example 2: Working with Classes
+### Example 2: Working with URLs
 
 ```python
-# Extract an entire class
+# Explore a GitHub file
+symbols = get_symbols("https://raw.githubusercontent.com/user/repo/main/src/api.py")
+
+# Extract function from GitLab
+result = get_function("https://gitlab.com/user/project/-/raw/main/utils.py", "helper_func")
+
+# Get lines from any URL
+lines = get_lines("https://example.com/code/script.py", 10, 25)
+```
+
+### Example 3: Working with Classes
+
+```python
+# Extract an entire class (local file)
 result = get_class("models/user.py", "User")
 # Returns: Complete User class with all methods
 
+# Extract class from URL
+result = get_class("https://raw.githubusercontent.com/user/repo/main/models.py", "DatabaseModel")
+
 # Get specific lines (e.g., just the __init__ method)
 lines = get_lines("models/user.py", 10, 25)
 # Returns: Lines 10-25 of the file
 ```
 
-### Example 3: Multi-Language Support
+### Example 4: Multi-Language Support
 
 ```javascript
 // Works with JavaScript/TypeScript