Legacy Client MCP Server

A tool that connects Claude with GitHub repositories through the MCP protocol, supporting functions such as code analysis and deployment workflow generation.

Developer tools Version control #Code Analysis #Workflow Generation #Repository Interaction #AI Assistance .Python

rating : 2 points

downloads : 8

update time : 2025-04-28

What is the GitHub Repository Assistant?

This is an AI-based GitHub repository assistant that enables Claude AI to analyze and operate on the content of GitHub repositories through the MCP protocol. It can help you understand the code structure, generate deployment configuration files, and answer code-related questions.

How to use the GitHub Repository Assistant?

Simply provide the GitHub repository URL, and the system will automatically clone and analyze the repository content. Then you can interact with the AI in natural language to get code explanations or generate various configuration files.

Use Cases

Suitable for scenarios where you need to quickly understand new projects, generate deployment configurations, get code explanations, or automate part of the development process. Particularly suitable for developers, technical project managers, and DevOps engineers.

Main Features

Repository AnalysisAutomatically clone and analyze the content of GitHub repositories to understand the project structure and key files.

Code GenerationGenerate configuration files such as deployment workflows and Dockerfiles according to requirements.

Natural Language InteractionAsk questions and get code explanations in everyday language without using professional terms.

Visual InterfaceOperate through the friendly interface provided by Streamlit without using the command line.

Advantages and Limitations

Advantages

No need to manually clone and analyze code repositories

Obtain professional-level deployment configurations through natural language

The visual interface lowers the usage threshold

Supports the generation of various common deployment scenarios and configurations

Limitations

Only supports public GitHub repositories

Analyzing large repositories may take a long time

The generated configurations may need manual fine-tuning

Depends on the Anthropic API service

How to Use

Installation Preparation

Ensure that Python 3.13+ and Git are installed, and obtain an Anthropic API key.

Configure the Environment

Set the API key in the.env file.

Start the Application

Run the Streamlit front-end interface.

Connect to the Server

Enter the path of server.py in the interface and click Connect.

Analyze the Repository

Enter the GitHub repository URL and click the Analyze button.

Usage Examples

Quickly Understand a New ProjectWhen taking over a new project, use this tool to quickly understand the project structure and key files.

Automated Deployment ConfigurationGenerate a standard deployment workflow for the project to save time on manual configuration.

Code Question AnsweringGet an explanation or modification suggestions for a specific code snippet.

Frequently Asked Questions

Is there a fee for using it?

Does it support private repositories?

What should I do if an error occurs when analyzing a large repository?

Can the generated configurations be used directly?

Related Resources

GitHub Official Documentation

Documentation for using GitHub and its API.

Anthropic API Documentation

Guide for using the Claude API.

Streamlit Tutorial

Guide for developing Streamlit applications.

Example Repository

An example project for demonstration.

🚀 GitHub Repository Assistant

A tool that connects Claude to GitHub repositories using the Model Control Protocol (MCP), allowing users to analyze code and get assistance with tasks such as creating deployment workflows.

🚀 Quick Start

Prerequisites

Python 3.13 or higher
Git installed and added to the PATH
Anthropic API key

Installation

Clone this repository:

git clone <your-repo-url>
cd <repo-directory>

Install the required dependencies:

pip install -r requirements.txt

Set your Anthropic API key in the .env file:

ANTHROPIC_API_KEY=your_api_key_here

Usage

Start the Streamlit application:

streamlit run app.py

In the sidebar, connect to the MCP server by entering the path to the server.py file in the "Server script path" field and clicking "Connect to server".
Enter a GitHub repository URL (e.g., https://github.com/deploypilotorg/example-repo) and click "Analyze repository".
Once the repository is analyzed, you can interact with it by asking questions or requesting tasks, such as:
- "What files are in this repository?"
- "What is the purpose of the main.py file?"
- "Create a GitHub Actions workflow for this code"
- "Generate a Dockerfile for this application"

✨ Features

Clone and analyze any GitHub repository
Interact with the repository via Claude 3.5 Sonnet
Request deployment workflows and other code generation tasks
Seamless integration through a Streamlit frontend
An MCP server equipped with specialized tools for repository interaction

🔧 Technical Details

The application uses the Model Control Protocol (MCP) to enable Claude to interact with GitHub repositories through specialized tools:

The MCP server (server.py) provides tools for cloning, analyzing, and reading GitHub repositories.
The Streamlit frontend (app.py) provides a user-friendly interface for interaction.
Claude uses the provided tools to understand the repository structure and generate relevant responses.

📚 Documentation

Limitations

Currently, only public GitHub repositories are supported.
Cloning and analyzing large repositories may take longer.
The generated deployment workflows may need to be manually adjusted according to specific requirements.