# Gitee MCP

> Gitee MCP gives your AI client full command over your collaborative code base. Stop clicking through web interfaces to manage repos, track bugs, or review pull requests. This connector lets you ask natural language questions—like 'What commits were made on the staging branch last week?' or 'Create a new issue for this broken login flow'—and get instant, actionable data back from Gitee.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** git-repository, code-hosting, issue-tracking, pull-requests, version-control, software-development

## Description

Dealing with large codebases means jumping between tabs: checking repo status here, opening an issue tracker there, and finally reviewing pull requests somewhere else. That friction slows you down.

This MCP connects your AI client directly to Gitee's core functions. Instead of navigating the web interface, you talk to your agent. Your agent reads repository data, lists all projects belonging to a user, and even generates new repositories on demand. Need to track something? You can list existing issues or create brand-new ones with just a prompt. When code changes, you don't have to manually audit the history; your agent pulls commit logs and details for specific files right into your conversation. This ability to treat complex development processes like a natural dialogue makes managing dev workflows simple. It’s exactly what Vinkius built this catalog for: giving power users direct access to deep service functionality through conversational AI.

## Tools

### get_user
Retrieves the profile information for the authenticated user on Gitee.

### list_pull_requests
Shows a list of existing pull requests associated with repositories.

### list_repo_commits
Provides a log detailing commits made within a specific repository.

### list_repo_issues
Generates a list of bugs or feature requests logged for a repository.

### list_user_repos
Lists all repositories owned by the currently authenticated user account.

### create_issue
Creates and logs a brand new issue detailing a problem or suggestion in a repository.

### create_pull_request
Initiates a pull request to merge changes between branches.

### create_repo
Creates an entirely new, blank repository account on Gitee.

### get_file_content
Fetches and reads the actual text content of a specified file path in a repository.

### get_repo
Retrieves general structural details about a specific repository.

## Prompt Examples

**Prompt:** 
```
List all my repositories on Gitee.
```

**Response:** 
```
I've retrieved your Gitee repositories. You have 5 active projects, including 'awesome-project' and 'demo-app'. Would you like more details on any of them?
```

**Prompt:** 
```
Create a new issue in 'my-org/my-repo' titled 'Bug: login failure'.
```

**Response:** 
```
Done! I've created issue #42 in the 'my-org/my-repo' repository with the title 'Bug: login failure'. You can track it here: [link].
```

**Prompt:** 
```
Read the contents of README.md from the main branch of 'user/project'.
```

**Response:** 
```
I've retrieved the README.md content for you. It contains project documentation, installation steps, and usage examples. Would you like me to summarize it?
```

## Capabilities

### View and Manage Code Repositories
The agent can list all your user repositories, get detailed project information, and create entirely new ones.

### Track Bugs and Features
You can view lists of repository issues or create a new issue to track bugs without leaving your workspace.

### Manage Code Changes
The system monitors pull requests for review and allows you to initiate the creation of a new pull request directly from your prompt.

### Audit Code History
You can retrieve comprehensive lists of commit logs or read specific file contents using just descriptive language.

## Use Cases

### The onboarding developer needs project context
A new dev asks their agent: 'What's the current state of the payment module?' The agent calls get_repo and then gets_file_content for key files, summarizing which parts need attention. They didn't have to read a massive README file.

### The PM needs to track down legacy bugs
A manager asks the agent: 'Show me all issues related to user authentication created last quarter.' The agent uses list_repo_issues, filters by date/label, and presents a clear report without needing manual filtering.

### The team needs to propose a new feature
A developer prompts: 'I need a place for the new reporting tool code.' The agent uses create_repo, generating the necessary project structure instantly and providing the link.

### The core dev is merging changes and needs to review them
Instead of manually opening the PR list, they ask: 'List all open pull requests for the main branch.' The agent calls list_pull_requests, giving an immediate status overview.

## Benefits

- Instead of jumping to the issue tracker page, simply ask your agent to list repository issues or create a new one. This makes bug reporting immediate and contextual.
- You can perform advanced code audits without opening multiple tabs. Just prompt for commit logs or file contents; the data appears instantly in your chat window.
- Need a new project? Use the tool that creates repositories so you don't have to manually navigate the creation forms on the web platform.
- Reviewing code changes is faster than ever. The ability to list pull requests means you can check status and initiate reviews without leaving your development environment.
- This MCP lets you manage everything from listing user repositories to getting detailed repo information, giving you a single pane of glass for all your projects.

## How It Works

The bottom line is you use natural language commands through your agent rather than clicking buttons in a web dashboard.

1. Subscribe to this MCP and provide your Gitee Personal Access Token (PAT) within Vinkius.
2. Connect your preferred agent, like Cursor or Claude, to the Vinkius platform.
3. Ask your AI client to perform a development task—for example, 'List all repos for me' or 'Create an issue detailing X bug.' — and get the result instantly.

## Frequently Asked Questions

**How do I list my user repositories using Gitee MCP?**
You simply ask your agent to list all user repositories. The system runs the list_user_repos tool and returns a comprehensive list of every project you own.

**Can I create an issue in Gitee via the Gitee MCP?**
Yes, you can. Just ask your agent to 'Create a new issue' in a specific repository, detailing the title and body content for bug tracking.

**What if I need to see old code history with Gitee MCP?**
You prompt the agent to list repository commits. It executes list_repo_commits, showing you a detailed log of changes across your specified branches and projects.

**Does Gitee MCP help me review pull requests?**
Yes, you can use list_pull_requests to see the status of open or closed PRs. You can even ask the agent to create a new pull request for merging code.

**Is Gitee MCP only for large teams?**
No. While it's powerful for teams, solo developers use it constantly too. It lets you list your own repositories and manage personal projects just as easily.