Getting Started

Quick Install

Click one of the buttons below to install the MCP server in your preferred IDE:

Install in VS Code Install in VS Code Insiders Install in Visual Studio Install in Cursor Install in Goose Add MCP Server GitCode API to LM Studio

Manual Installation

Note: When you install the MCP server, you may be prompted to enter the following:

  • GITCODE_ACCESS_TOKEN: Replace placeholder value ${input:gitcode_access_token} with your actual GitCode access token and you can start using the service.

Standard config works in most tools:

{
  "servers": {
    "GitCode API": {
      "command": "uvx",
      "args": [
        "--from",
        "gitcode-api[mcp]",
        "gitcode-api",
        "serve"
      ],
      "env": {
        "GITCODE_ACCESS_TOKEN": "${input:gitcode_access_token}"
      }
    }
  }
}
VS Code

Click the button to install:

Install in VS Code

Or install manually:

Follow the MCP install guide, use the standard config above. You can also install the GitCode API MCP server using the VS Code CLI:

code --add-mcp '{\"name\":\"GitCode API\",\"command\":\"uvx\",\"args\":[\"--from\",\"gitcode-api[mcp]\",\"gitcode-api\",\"serve\"],\"env\":{\"GITCODE_ACCESS_TOKEN\":\"${input:gitcode_access_token}\"},\"inputs\":[{\"id\":\"gitcode_access_token\",\"type\":\"promptString\",\"description\":\"Enter GITCODE_ACCESS_TOKEN\",\"password\":true}]}'

After installation, the GitCode API MCP server will be available for use with your GitHub Copilot agent in VS Code.

VS Code Insiders

Click the button to install:

Install in VS Code Insiders

Or install manually:

Follow the MCP install guide, use the standard config above. You can also install the GitCode API MCP server using the VS Code Insiders CLI:

code-insiders --add-mcp '{\"name\":\"GitCode API\",\"command\":\"uvx\",\"args\":[\"--from\",\"gitcode-api[mcp]\",\"gitcode-api\",\"serve\"],\"env\":{\"GITCODE_ACCESS_TOKEN\":\"${input:gitcode_access_token}\"},\"inputs\":[{\"id\":\"gitcode_access_token\",\"type\":\"promptString\",\"description\":\"Enter GITCODE_ACCESS_TOKEN\",\"password\":true}]}'

After installation, the GitCode API MCP server will be available for use with your GitHub Copilot agent in VS Code Insiders.

Visual Studio

Click the button to install:

Install in Visual Studio

Or install manually:

  1. Open Visual Studio
  2. Navigate to the GitHub Copilot Chat window
  3. Click the tools icon (🛠️) in the chat toolbar
  4. Click the + "Add Server" button to open the "Configure MCP server" dialog
  5. Fill in the configuration:
    • Server ID: GitCode API
    • Type: Select stdio from the dropdown
    • Command: uvx
    • Arguments: --from gitcode-api[mcp] gitcode-api serve
    • Environment Variables: Configure as needed
    • Note: You'll be prompted for secure values during installation
  6. Click "Save" to add the server

For detailed instructions, see the Visual Studio MCP documentation.

Cursor

Click the button to install:

Install in Cursor

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command from the standard config above. You can also verify config or add command like arguments via clicking Edit.

Goose

Click the button to install:

Install in Goose

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command from the standard config above. Click "Add Extension".

LM Studio

Click the button to install:

Add MCP Server GitCode API to LM Studio

Or install manually:

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.

Claude Code

Use the Claude Code CLI to add the GitCode API MCP server:

claude mcp add GitCode API uvx --from gitcode-api[mcp] gitcode-api serve
Claude Desktop

Follow the MCP install guide, use the standard config above.

Alternatively, download the gitcode-<version>.mcpb asset from the matching GitHub Release and install it in Claude Desktop (double-click, drag-and-drop, or Settings → Extensions → Advanced settings → Install Extension…). That format is Anthropic’s MCP bundle for local servers; see Build a desktop extension with MCPB.

Codex

Create or edit the configuration file ~/.codex/config.toml and add:

[mcp_servers.GitCode API]
command = "uvx"
args = ["--from", "gitcode-api[mcp]", "gitcode-api", "serve"]

For more information, see the Codex MCP documentation.

Gemini CLI

Follow the MCP install guide, use the standard config above.

OpenCode

Follow the MCP Servers documentation. For example in ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "GitCode API": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "gitcode-api[mcp]",
        "gitcode-api",
        "serve"
      ],
      "enabled": true
    }
  }
}
GitHub Copilot Coding Agent

GitHub Copilot Coding Agent can use MCP servers to extend its capabilities. Use the configuration below specifically formatted for the Coding Agent:

{
  "mcpServers": {
    "GitCode API": {
      "command": "uvx",
      "args": [
        "--from",
        "gitcode-api[mcp]",
        "gitcode-api",
        "serve"
      ],
      "env": {
        "GITCODE_ACCESS_TOKEN": "${input:gitcode_access_token}"
      },
      "type": "local",
      "tools": [
        "*"
      ]
    }
  }
}

Add this configuration to your repository settings under Copilot > Coding agent. The "tools": ["*"] setting enables all available tools from the MCP server.

For more information, see the GitHub Copilot Coding Agent MCP documentation.

Configuration Details

  • Server Name: GitCode API
  • Type: UVX Package
  • Package: gitcode-api
  • From: gitcode-api[mcp]

Optional — quiet stdio startup: Some hosts prefer minimal stdout noise from MCP servers. Append --show-banner and false to the serve arguments (after serve):

"args": [
  "--from",
  "gitcode-api[mcp]",
  "gitcode-api",
  "serve",
  "--show-banner",
  "false"
]

Need Help?

For more information about the Model Context Protocol, visit modelcontextprotocol.io.