MCP Server Demo

A demonstration MCP (Model Context Protocol) server that provides tools for project analysis and README generation.

Features

• Project Structure Analysis: Scan and analyze project directories
• File Reading: Read contents of specific files
• README Generation: Automatically generate comprehensive README files
• Project Information: Get detailed project insights and statistics

Installation

1. Clone the repository
2. Install dependencies (if any):

   pip install -r requirements.txt
   

Usage

Run the MCP server:

python github_readme.py

The server provides the following tools:

• scan_project(project_path) - Analyze project structure
• read_file(file_path) - Read file contents
• generate_readme(project_path, project_name, description) - Generate README
• save_readme(project_path, readme_content) - Save README to file

Project Structure

├── github_readme.py    # Main MCP server implementation
├── pyproject.toml      # Project configuration
└── uv.lock            # Lock file

Requirements

• Python 3.13+
• MCP (Model Context Protocol) framework (Like Claude Desktop..)