{"id":26293724,"url":"https://github.com/normal-coder/gitee-mcp-server","last_synced_at":"2025-10-24T13:06:11.028Z","repository":{"id":281282387,"uuid":"943946428","full_name":"normal-coder/gitee-mcp-server","owner":"normal-coder","description":"Let AI operate Gitee Repositories / Issues / Pull Requests for you through MCP","archived":false,"fork":false,"pushed_at":"2025-03-08T02:19:55.000Z","size":65,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-08T03:18:51.680Z","etag":null,"topics":["cline","cursor","gitee","mcp","mcp-server","windsurf","zed"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/gitee-mcp-server","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/normal-coder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-06T14:28:48.000Z","updated_at":"2025-03-08T02:19:58.000Z","dependencies_parsed_at":"2025-03-08T03:28:57.634Z","dependency_job_id":null,"html_url":"https://github.com/normal-coder/gitee-mcp-server","commit_stats":null,"previous_names":["normal-coder/gitee-mcp-server"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/normal-coder%2Fgitee-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/normal-coder%2Fgitee-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/normal-coder%2Fgitee-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/normal-coder%2Fgitee-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/normal-coder","download_url":"https://codeload.github.com/normal-coder/gitee-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243674422,"owners_count":20329098,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cline","cursor","gitee","mcp","mcp-server","windsurf","zed"],"created_at":"2025-03-15T02:30:10.456Z","updated_at":"2025-10-24T13:06:11.010Z","avatar_url":"https://github.com/normal-coder.png","language":"TypeScript","funding_links":[],"categories":["Version Control","Business Tools"],"sub_categories":["How to Submit"],"readme":"# Gitee MCP Server\n\nLet AI operate Gitee repositories/Issues/Pull Requests for you through MCP\n\n[![Node Version](https://img.shields.io/badge/node-%3E%3D22.12.0-brightgreen.svg)](./package.json)\n![NPM Version](https://img.shields.io/npm/v/gitee-mcp-server)\n![Docker Pulls](https://img.shields.io/docker/pulls/normalcoder/gitee-mcp-server)\n![Docker Image Version](https://img.shields.io/docker/v/normalcoder/gitee-mcp-server)\n[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![smithery badge](https://smithery.ai/badge/@normal-coder/gitee-mcp-server)](https://smithery.ai/server/@normal-coder/gitee-mcp-server)\n\n[\u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/cck9xigm1d/badge\" /\u003e](https://glama.ai/mcp/servers/Cck9XigM1d)\n\n---\n\n## Supported AI Operations\n\n| Category | MCP Tool | Description |\n|:----:|:----|:----|\n| Repository Operations | `create_repository` | Create a Gitee repository | \n| | `fork_repository` | Fork a Gitee repository | \n| Branch Operations | `create_branch` | Create a new branch in a Gitee repository | \n| | `list_branches` | List branches in a Gitee repository | \n| | `get_branch` | Get details of a specific branch in a Gitee repository | \n| File Operations | `get_file_contents` | Get contents of a file or directory in a Gitee repository | \n| | `create_or_update_file` | Create or update a file in a Gitee repository | \n| | `push_files` | Push multiple files to a Gitee repository | \n| Issue Operations | `create_issue` | Create an Issue in a Gitee repository | \n| | `list_issues` | List Issues in a Gitee repository | \n| | `get_issue` | Get details of a specific Issue in a Gitee repository | \n| | `update_issue` | Update an Issue in a Gitee repository | \n| | `add_issue_comment` | Add a comment to an Issue in a Gitee repository | \n| Pull Request Operations | `create_pull_request` | Create a Pull Request in a Gitee repository | \n| | `list_pull_requests` | List Pull Requests in a Gitee repository | \n| | `get_pull_request` | Get details of a specific Pull Request in a Gitee repository | \n| | `update_pull_request` | Update a Pull Request in a Gitee repository | \n| | `merge_pull_request` | Merge a Pull Request in a Gitee repository | \n| User Operations | `get_user` | Get Gitee user information | \n| | `get_current_user` | Get authenticated Gitee user information | \n\n## Usage\n\n### Installing via Smithery\n\nTo install Gitee MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@normal-coder/gitee-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @normal-coder/gitee-mcp-server --client claude\n```\n\n### Configuration\n\n- `GITEE_API_BASE_URL`: Optional, Gitee OpenAPI Endpoint, default is `https://gitee.com/api/v5`\n- `GITEE_PERSONAL_ACCESS_TOKEN`: Required, Gitee account personal access token (PAT), can be obtained from Gitee account settings [Personal Access Tokens](https://gitee.com/profile/personal_access_tokens)\n- `DEBUG`: Optional, set to `true` to enable debug logging, default is disabled\n\n### Run MCP Server via NPX\n\n```json\n{\n  \"mcpServers\": {\n    \"Gitee\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"gitee-mcp-server\"\n      ],\n      \"env\": {\n        \"GITEE_PERSONAL_ACCESS_TOKEN\": \"\u003cYOUR_TOKEN\u003e\"\n      }\n    }\n  }\n}\n```\n\n### Run MCP Server via Docker Container\n\n1. Get Docker Image\n\n```bash\n# Get from DockerHub\ndocker pull normalcoder/gitee-mcp-server\n\n# Build locally\ndocker build -t normalcoder/gitee-mcp-server .\n```\n\n2. Configure MCP Server\n\n```json\n{\n  \"mcpServers\": {\n    \"Gitee\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"GITEE_PERSONAL_ACCESS_TOKEN\",\n        \"normalcoder/gitee-mcp-server\"\n      ],\n      \"env\": {\n        \"GITEE_PERSONAL_ACCESS_TOKEN\": \"\u003cYOUR_TOKEN\u003e\"\n      }\n    }\n  }\n}\n```\n\n## Development Guide\n\n### Install Dependencies\n\n```bash\nnpm install\n```\n\n### Build\n\n```bash\nnpm run build\n```\n\nAfter successful build, `/dist` will contain the runnable MCP server.\n\n### Run Server\n\n```bash\nnpm start\n```\n\nThe MCP server will run on stdio, allowing it to be used as a subprocess by MCP clients.\n\n### Build Docker Image\n\nYou can also run the server using Docker:\n\n```bash\ndocker build -t normalcoder/gitee-mcp-server .\n```\n\nRun MCP Server with Docker:\n\n```bash\ndocker run -e GITEE_PERSONAL_ACCESS_TOKEN=\u003cYOUR_TOKEN\u003e normalcoder/gitee-mcp-server\n```\n\n### Debug MCP Server\n\nYou can use `@modelcontextprotocol/inspector` for debugging:\n\nCreate a `.env` file in the root directory for environment variables:\n\n```.env\nGITEE_API_BASE_URL=https://gitee.com/api/v5\nGITEE_PERSONAL_ACCESS_TOKEN=\u003cYOUR_TOKEN\u003e\n```\n\nRun the debug tool to start the service and web debug interface:\n\n```bash\nnpx @modelcontextprotocol/inspector npm run start --env-file=.env\n```\n\nThe project includes a `debug()` function for printing debug information, usage:\n\n```typescript\nimport { debug } from './common/utils.js';\n\ndebug('Message to log');\ndebug('Message with data:', { key: 'value' });\n```\n\nDebug logs are only printed when the `DEBUG` environment variable is set to `true`.\n\n## Dependencies\n\n- `@modelcontextprotocol/sdk`: MCP SDK for server implementation\n- `universal-user-agent`: For generating user agent strings\n- `zod`: For schema validation\n- `zod-to-json-schema`: For converting Zod schemas to JSON schemas\n\n## License\n\nLicensed under MIT License. You are free to use, modify and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the [LICENSE](./LICENSE) file in the project repository.\n\n## Related Links\n\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [Gitee](https://gitee.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnormal-coder%2Fgitee-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnormal-coder%2Fgitee-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnormal-coder%2Fgitee-mcp-server/lists"}