Overview
What is Gitcode?
Gitcode is a Go implementation of an MCP server that wraps the GitCode API into the Model Context Protocol. It enables AI coding assistants to interact with GitCode repositories, issues, pull requests, and search functionality through a standard MCP interface.
How to use Gitcode?
Install via the provided install.sh script or run go install github.com/gitcode-org-com/gitcode-mcp@latest. Set the GITCODE_TOKEN and GITCODE_API_URL environment variables, then start the server with gitcode-mcp. Configure your AI platform (Claude, Cline, Cursor, Windsurf) using the reference config files in the docs directory.
Key features of Gitcode
- Complete support for major GitCode API features
- Implements standard MCP protocol with STDIO and SSE transports
- Lightweight with fast response times
- Strong concurrent processing for high-load scenarios
- Modular code structure for easy extension
Use cases of Gitcode
- List, view, and create GitCode repositories via MCP
- Manage repository branches, issues, and pull requests
- Search code, repositories, issues, or users on GitCode
- Integrate GitCode workflows with AI coding assistants
- Automate repository management tasks through MCP tools
FAQ from Gitcode
What runtime and dependencies are required?
Go 1.16+ and network access to the GitCode API. No other runtime dependencies.
How do I authenticate with the GitCode API?
Set the GITCODE_TOKEN environment variable to your GitCode access token. The API endpoint defaults to https://api.gitcode.com/api/v5 but can be overridden via GITCODE_API_URL.
What transport modes does the server support?
It supports both STDIO and SSE transports, as defined by the MCP specification.
Can I use Gitcode with Claude, Cline, Cursor, or Windsurf?
Yes. The docs directory includes reference configuration JSON files for each of these platforms.
Are there any known limits on API usage or tool capabilities?
No limits are mentioned in the README. The server leverages the GitCode API and its inherent rate limits.
