Mcp Gitee

purpose

The Gitee MCP Server is designed to implement the Model Context Protocol (MCP) for integration with Gitee, facilitating interactions with Gitee's API. It enables AI assistants to manage repositories, issues, pull requests, notifications, and other related operations within the Gitee environment.

architecture

The MCP Server is built on Go programming language, leveraging Gitee's API for interaction. It uses configurable command-line flags and environment variables for setup. Transport options include stdio and SSE, making it adaptable to both personal and enterprise environments.

capabilities

The server provides tools for repository management, issue tracking, pull request handling, user notifications, and authentication. It supports scalable operations across personal accounts, organizational instances, and enterprise repositories. It simplifies workflows by offering automation capabilities for repository interactions.

running instructions

To run the MCP server: 1. Install prerequisites: Go 1.23.0 or higher and a Gitee account with an access token. 2. Clone the repository: ```bash git clone https://gitee.com/oschina/mcp-gitee.git cd mcp-gitee ``` 3. Build the project: ```bash make build ``` Move ./bin/mcp-gitee to the PATH environment. 4. Alternatively, install using go: ```bash go install gitee.com/oschina/mcp-gitee@latest ``` 5. Start the server with appropriate flags: ```bash mcp-gitee --version ``` Configuration can be done using JSON objects or environment variables such as `GITEE_ACCESS_TOKEN` and `GITEE_API_BASE`.

use cases

1. Automating issue tracking and resolution on Gitee. 2. Managing repositories for personal, organizational, or enterprise use. 3. Creating and handling pull requests based on tracked issues. 4. Notification tracking and management for users. 5. Integration of Gitee functionalities with AI support for enhanced workflows.

features

1. Interaction with Gitee repositories, issues, pull requests, and notifications. 2. Configurable API base URL for different Gitee instances. 3. Command-line flags for user-friendly configuration. 4. Compatibility with personal, organizational, and enterprise operations. 5. Environment variable support for streamlined setup.

tools

[ { "name": "create_user_repo", "description": "Create a user repository within the Gitee space." }, { "name": "create_org_repo", "description": "Create an organizational repository on Gitee." }, { "name": "create_enter_repo", "description": "Create an enterprise repository for enhanced professional use." }, { "name": "list_repo_pulls", "description": "List pull requests in a specified repository." }, { "name": "merge_pull", "description": "Merge an existing pull request into the repository." }, { "name": "create_pull", "description": "Create a new pull request based on issue details." }, { "name": "update_pull", "description": "Update information related to an existing pull request." }, { "name": "comment_issue", "description": "Add comments to an issue for discussions or solutions." }, { "name": "create_issue", "description": "Open a new issue for tracking or resolution." }, { "name": "list_issue_comments", "description": "View comments posted on an issue." }, { "name": "get_user_info", "description": "Fetch details of the authenticated user." }, { "name": "list_user_notifications", "description": "Retrieve notifications for the user in their Gitee account." } ]