# Gitee MCP for AI Agents AI Agent Connect

> Gitee MCP lets your AI agent handle your code hosting and development workflow on Gitee. Instead of clicking through a web UI, you can ask your agent to manage repositories, track issues, and handle pull requests. It connects your AI client directly to your Gitee projects for faster updates and easier organization.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_8m9nw1WZQ5BV5pR56rKb4GBM6fVy4XDmkY9qdu9T/ai-agent-connect
- **Tags:** git-repository, code-hosting, issue-tracking, pull-requests, version-control, software-development

## Description

You spend a lot of time jumping between tabs to check on your code, update issue statuses, and review pull requests. This Connector changes that by letting your AI agent handle the heavy lifting of repository management on Gitee. When you connect Gitee to your agent, you can just talk about your projects. You can ask for a summary of recent changes, create a new issue for a bug you just found, or get the contents of a specific file without leaving your workspace. It turns a manual, multi-click process into a conversation. Whether you're managing a massive open-source project or just keeping your own dev notes organized, this connection makes the platform feel like an extension of your own workflow. You'll find this is one of the most practical ways to use the Vinkius catalog to keep your development moving without the friction of manual navigation. Instead of being buried in web UI menus, you get direct access to your project data, making it easier to stay in the zone and get things done.

## Tools

### create_issue
Create a new issue to track a bug or task. This lets you log problems as soon as they happen.

### create_pull_request
Create a new pull request to merge your changes. This makes it easy to submit code for review without manual entry.

### create_repo
Create a fresh repository for a new project. Use this to spin up new work instantly.

### get_file_content
Read the text inside any specific file in a repository. This helps your agent understand your code's current state.

### get_repo
Get the specific details and metadata for a repository. Use this to verify project settings and info.

### get_user
Fetch the profile information for the authenticated user. This helps the agent identify who is making the requests.

### list_pull_requests
See all open and closed pull requests for a project. Use this to stay on top of your team's merged code.

### list_repo_commits
See a full list of commits for a specific repository. This is great for auditing the project's history.

### list_repo_issues
See all issues currently tracked in a repository. This helps you keep your bug tracker organized.

### list_user_repos
See every repository associated with your user account. Use this to get a high-level view of your work.

## Prompt Examples

**Prompt:** 
```
What's the status of the pull requests for my 'web-app' project?
```

**Response:** 
```
I've checked the pull requests for the **web-app** project. Here is the current status:

| PR # | Title | Status | Author |
| :--- | :--- | :--- | :--- |
| 42 | Fix login auth bug | **Open** | dev_user_1 |
| 45 | Update landing page | **Merged** | dev_user_2 |
| 48 | Add dark mode toggle | **Draft** | dev_user_1 |

Would you like me to see more details on any of these?
```

**Prompt:** 
```
Create a new issue in the 'mobile-api' repo for a memory leak in the auth module.
```

**Response:** 
```
Done! I've created a new issue in the **mobile-api** repository:

*   **Issue ID:** #57
*   **Title:** Memory leak in auth module
*   **Description:** Reported memory leak identified in the authentication module during high-concurrency tests.

You can track it here: [link_to_issue]
```

**Prompt:** 
```
Show me the last 5 commits for the 'frontend' repository.
```

**Response:** 
```
Here are the most recent commits for the **frontend** repository:

*   **a1b2c3d** - Update CSS for navigation bar (2 hours ago)
*   **e5f6g7h** - Fix typo in footer (5 hours ago)
*   **i9j0k1l** - Refactor button components (Yesterday)
*   **m2n3o4p** - Add new icon set (2 days ago)
*   **q5r6s7t** - Update dependency versions (3 days ago)
```

## Capabilities

### Create new repositories
Spin up a new project on Gitee instantly through your AI client.

### List all your user repositories
Get a high-level view of every project associated with your account.

### Create new issues for bug tracking
Log problems or tasks to your repository without leaving your workspace.

### List and filter existing repository issues
Find specific bugs or tasks using natural language queries.

### Create and monitor pull requests
Submit code changes and track their status through your agent.

### List all pull requests in a project
See what's pending for review across your entire repository.

### Read specific file contents from a repo
Have your agent read the contents of any file to provide immediate context.

### Browse full commit histories
Audit changes and view the timeline of a project's development.

## Use Cases

### Instant Bug Reporting
A developer finds a login bug and asks the agent to use `create_issue` to log it in the main repository immediately.

### Rapid Code Review
A maintainer asks the agent to use `list_pull_requests` to see what needs attention today to keep the project moving.

### Seamless Onboarding
A new developer asks the agent to use `get_file_content` to read the README and setup instructions without searching the web.

### Project Auditing
A manager asks the agent to use `list_user_repos` to see every project the team is currently hosting for a status update.

## Benefits

- Stop navigating web menus by using `list_user_repos` to see all your projects instantly.
- Track bugs faster by using `create_issue` to log problems as soon as you find them.
- Review code changes more efficiently by using `list_pull_requests` to see what's pending.
- Get instant context on your codebase by using `get_file_content` to read specific files.
- Keep your project history organized by using `list_repo_commits` to audit changes.
- Spin up new projects quickly by using `create_repo` without leaving your chat interface.

## How It Works

The bottom line is you get a conversational interface for your Gitee development workflow.

1. Subscribe to the Gitee MCP on Vinkius.
2. Provide your Gitee Personal Access Token (PAT).
3. Ask your AI client to perform repository actions like listing issues or creating pull requests.

## Frequently Asked Questions

**Can the Gitee MCP help me manage my project issues?**
Yes, it lets your agent create and list issues directly in your repositories. You can log bugs or track tasks using natural language without leaving your AI client.

**How do I use Gitee MCP to see my repositories?**
You can ask your agent to list all the repositories associated with your user account. It will pull the list directly from Gitee for you.

**Can my AI agent read files on Gitee?**
Yes, the Connector allows your agent to retrieve the contents of specific files. This is great for having the agent analyze code or documentation on the fly.

**Does Gitee MCP work with Cursor?**
Yes, it works with any MCP-compatible client, including Cursor, Claude, and Windsurf, giving you a unified way to manage your Gitee projects.

**How do I set up Gitee MCP for my team?**
Just subscribe to the Connector on Vinkius and provide your Gitee Personal Access Token. From there, your agent can start managing the team's projects.

**Can I use Gitee MCP to create new projects?**
Yes, you can ask your agent to create a new repository on Gitee. It handles the creation process so you don't have to navigate the web interface.

**How do I find my Gitee Personal Access Token?**
Log in to Gitee, go to [Settings -> Personal Access Tokens](https://gitee.com/profile/personal_access_tokens), and click 'Generate new token'. Make sure to copy it immediately as it won't be shown again.

**Can I read the content of a file in a private repository?**
Yes, as long as your Personal Access Token has the necessary permissions (scopes) to access your private repositories, the `get_file_content` tool will work perfectly.

**Is it possible to filter issues by their state?**
Yes. When using `list_repo_issues`, you can provide an optional `state` parameter (e.g., 'open', 'closed', or 'all') to filter the results according to your needs.