Commit 611a48e

@@ -0,0 +1,155 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a **production-ready** Go-based MCP (Model Context Protocol) server implementation with **100% feature parity** to reference implementations. The project includes multiple specialized MCP servers that follow JSON-RPC 2.0 protocol for AI assistant integrations.
+
+## 🎉 Current Status: COMPLETE
+
+**All 4 enhancement phases have been successfully implemented:**
+- ✅ Phase 1: Advanced HTML Processing (goquery + html-to-markdown) 
+- ✅ Phase 2: Interactive Prompts Support (user/assistant conversations)
+- ✅ Phase 3: Resources Support (file://, git://, memory:// URI schemes)
+- ✅ Phase 4: Roots Support (automatic capability discovery)
+
+## Architecture
+
+### Available MCP Servers
+Each server is a standalone binary in `/usr/local/bin/`:
+
+1. **mcp-git** - Git repository operations and browsing
+2. **mcp-filesystem** - Secure filesystem access with allowed directories
+3. **mcp-memory** - Knowledge graph management with entities/relations
+4. **mcp-fetch** - Web content fetching with advanced HTML processing
+5. **mcp-time** - Time and date utilities
+6. **mcp-sequential-thinking** - Structured thinking workflows
+
+### Protocol Implementation
+- **JSON-RPC 2.0** compliant MCP protocol
+- **Full capability advertisement**: tools, prompts, resources, roots, logging
+- **Secure by design**: filesystem access controls, input validation
+- **Thread-safe**: concurrent access with proper mutex locking
+
+## Development Commands
+
+### Build All Servers
+```bash
+make clean build
+```
+
+### Install System-wide
+```bash
+sudo make install
+```
+
+### Run Tests
+```bash
+go test ./...
+```
+
+### Individual Server Usage
+```bash
+# Git server
+mcp-git --repository /path/to/repo
+
+# Filesystem server  
+mcp-filesystem --allowed-directory /tmp,/home/user/projects
+
+# Memory server
+mcp-memory --memory-file /path/to/memory.json
+
+# Fetch server
+mcp-fetch
+
+# Time server
+mcp-time
+
+# Sequential thinking server
+mcp-sequential-thinking
+```
+
+## Enhanced Capabilities
+
+### 1. Advanced HTML Processing (Phase 1)
+- **Professional content extraction** using `goquery` 
+- **Clean markdown conversion** with `html-to-markdown`
+- **Automatic filtering** of ads, navigation, scripts, styles
+- **Significant improvement**: 137 lines of custom parsing → 13 lines with libraries
+
+### 2. Interactive Prompts (Phase 2) 
+- **fetch**: Interactive URL entry with optional reason context
+- **commit-message**: Conventional commit format guidance with breaking change support
+- **edit-file**: Step-by-step file editing workflow with security validation
+- **knowledge-query**: Memory graph exploration with context
+
+### 3. Resource Discovery (Phase 3)
+- **file:// scheme**: Direct filesystem access with security validation and MIME detection
+- **git:// scheme**: Repository browsing (files, branches, commits) with metadata
+- **memory:// scheme**: Knowledge graph exploration (entities, relations) as JSON resources
+- **Thread-safe implementation** with proper resource lifecycle management
+
+### 4. Root Capability Discovery (Phase 4)
+- **Automatic registration**: Each server registers its access points as roots
+- **Live statistics**: Memory server shows real-time entity/relation counts  
+- **Dynamic updates**: Root information updates when underlying data changes
+- **User-friendly names**: Descriptive root names with context (e.g., "Git Repository: mcp (branch: main)")
+
+## Testing Integration
+
+### Quick Capability Test
+```bash
+# Test server capabilities
+echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | mcp-git --repository .
+
+# Expected response includes all capabilities:
+# {"capabilities":{"logging":{},"prompts":{},"resources":{},"roots":{},"tools":{}}}
+```
+
+### Test Enhanced Features
+```bash
+# Test prompts
+echo '{"jsonrpc": "2.0", "id": 2, "method": "prompts/list"}' | mcp-fetch
+
+# Test resources  
+echo '{"jsonrpc": "2.0", "id": 3, "method": "resources/list"}' | mcp-git --repository .
+
+# Test roots
+echo '{"jsonrpc": "2.0", "id": 4, "method": "roots/list"}' | mcp-filesystem --allowed-directory /tmp
+
+# Test enhanced HTML processing
+echo '{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "fetch", "arguments": {"url": "https://example.com"}}}' | mcp-fetch
+```
+
+## Dependencies
+
+### Core Libraries
+- **go-git**: Git repository operations
+- **goquery**: Professional HTML parsing and content extraction  
+- **html-to-markdown**: Clean HTML to markdown conversion
+- **Standard library**: JSON-RPC, HTTP, filesystem, concurrency
+
+### Development Tools
+- **Makefile**: Build automation with `make build`, `make install`, `make clean`
+- **Go modules**: Dependency management with `go.mod`
+
+## Key Design Principles
+
+- **Security first**: Filesystem access controls, input validation, no arbitrary code execution
+- **Performance optimized**: Thread-safe concurrent operations, efficient resource management
+- **Standards compliant**: Full JSON-RPC 2.0 and MCP protocol implementation
+- **Production ready**: Comprehensive error handling, logging, graceful degradation
+- **Extensible architecture**: Easy to add new tools, prompts, and resource types
+
+## Integration Notes for Claude Code
+
+When working with this codebase:
+
+1. **The servers are fully functional** - all Phase 1-4 enhancements are complete and tested
+2. **Use the installed binaries** in `/usr/local/bin/` for testing integrations
+3. **Check PLAN.md** for detailed implementation history and test results
+4. **All MCP protocol features work**: tools, prompts, resources, roots discovery
+5. **Command-line flags are properly implemented** (--repository, --allowed-directory, --memory-file)
+
+This implementation provides a powerful foundation for AI-assisted development workflows with comprehensive MCP protocol support.
\ No newline at end of file