Easy MCP Github Tools Python

🚀 GitHub API Wrapper Tool

This project is a GitHub API interface encapsulation tool developed in Python. Its goal is to provide users with an easy-to-use interface to call various GitHub functions.

🚀 Quick Start

This project is a Python-based tool that encapsulates the GitHub API, enabling users to easily interact with GitHub's features.

✨ Features

• Fully implemented based on the official GitHub documentation.
• Supports almost all GitHub REST API functions.
• Provides user authentication and authorization features.
• Written in Python for good compatibility.

📦 Installation

Step 1: Project Initialization

1. Create a new Python project.
2. Initialize the project's version control tool (e.g., Git).

Step 2: Set Up the Basic Framework

1. Install the necessary dependency libraries:

pip install requests python-dotenv

2. Create a basic configuration file config.py to store some constants and settings.

Step 3: Implement API Interface Encapsulation

1. Encapsulate GitHub API request functions:
   • GET requests
   • POST requests
   • PUT requests
   • DELETE requests
2. Implement Token verification to ensure that each request carries a valid access token.

Step 4: Develop Core Business Logic

1. User authentication module:
   • Implement the OAuth 2.0 authorization process.
   • Generate and verify Tokens.
2. API request handling:
   • Encapsulate various GitHub REST API interfaces.
   • Process request parameters.
   • Return responses in standard JSON format.

Step 5: Develop the User Interface

1. Create a simple Web interface for user operations.
2. Visualize the request results.

Step 6: Testing and Optimization

1. Write unit test cases to ensure that all functions work properly.
2. Optimize the code structure and performance.

Deployment

To deploy this project, follow these steps:

git clone https://github.com/yourusername/YourProject.git
cd YourProject
pip install -r requirements.txt
python app.py

💻 Usage Examples

Example code for creating a new repository

from your_module import GitHubAPI

gh = GitHubAPI(token="your_token_here")
response = gh.create_repository(name="new-repo", description="This is a new repository")
print(response.status_code)
print(response.json())

Example code for getting user information

from your_module import GitHubAPI

gh = GitHubAPI(token="your_token_here")
user_info = gh.get_user_info(username="githubusername")
print(user_info)

📚 Documentation

Notes

1. All interfaces in the project need appropriate exception handling.
2. Ensure that the project's logging function is perfect for subsequent debugging and maintenance.
3. Regularly update the GitHub API version to maintain compatibility.

Tool Instructions

The detailed specifications of all tools can be found on the server information page where the {APP_HOST} parameter is configured in the .env file.

Screenshots

Server Information Page:

GitHub App OAuth Page

Authenticated User Page