mcp-demo

# GitHub Contracts Extractor A simple tool to extract Solidity contracts from GitHub repositories. ## Requirements - Python 3.13 or higher - [uv](https://github.com/astral-sh/uv) - Python package manager - Claude Desktop app ## Installation 1. Clone the repository: ``` git clone [repository-url] cd [repository-name] ``` 2. Create a virtual environment and install dependencies: ``` uv venv source .venv/bin/activate # On Windows, use: .venv\Scripts\activate uv pip install -e . ``` ## Setting Up with Claude Desktop 1. Download the latest Claude Desktop application 2. Configure MCP server by editing the Claude Desktop configuration: ``` code ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` 3. Add the following configuration (replace `Username` with your actual username): ```json { "mcpServers": { "github_contracts": { "command": "/Users/Username/.local/bin/uv", "args": [ "--directory", "/Users/Username/mcp-demo", "run", "/Users/Username/mcp-demo/github_contracts.py" ] } } } ``` 4. Restart Claude Desktop ## Usage ### Using with Claude Desktop After completing the setup, you can analyze smart contracts from GitHub repositories by simply typing: ``` audit smart contracts in the link ``` You can provide a GitHub repository URL, and Claude will extract and analyze the Solidity contracts. ## Project Structure - `github_contracts.py` - Main application for extracting Solidity contracts - `pyproject.toml` - Project configuration and dependencies ## License [Specify license information here]