gitcode_api.llm.mcp

FastMCP integration for the GitCode LLM tool.

Functions

create_mcp_gitcode_api_tool([tool])

Return the async callable that can be registered with an MCP server.

create_mcp_server([name, tool])

Create a FastMCP server with the GitCode API tool already registered.

register_mcp_gitcode_api_tool(mcp[, tool])

Register the GitCode API tool with an existing FastMCP-compatible server.

register_mcp_help_resources(mcp)

Register optional MCP resources that mirror gitcode_api_tool help text.

Classes

GitCodeMCP([name, tool])

Small FastMCP server wrapper exposing the GitCode API tool.
class GitCodeMCP(name: str = 'GitCode API', tool: GitCodeLLMTool | None = None, **kwargs: Any)

Bases: object

Small FastMCP server wrapper exposing the GitCode API tool.

Parameters:

  • name – MCP server name.

  • tool – Optional preconfigured shared GitCode LLM tool.

  • kwargs – Forwarded to fastmcp.FastMCP. If instructions is omitted, a default overview of the tool (parameters, byte encoding, and valid op_type values) is supplied.

Create a FastMCP server and register the GitCode API tool.

create_mcp_gitcode_api_tool(tool: GitCodeLLMTool | None = None) → Callable

Return the async callable that can be registered with an MCP server.

Parameters:

tool – Optional preconfigured shared GitCode LLM tool.

Returns:

Async callable using the standard GitCode tool parameters.

create_mcp_server(name: str = 'GitCode API', tool: GitCodeLLMTool | None = None, **kwargs: Any) → FastMCP

Create a FastMCP server with the GitCode API tool already registered.

Parameters:

  • name – MCP server display name.

  • tool – Optional preconfigured GitCodeLLMTool.

  • kwargs – Forwarded to GitCodeMCP and then to fastmcp.FastMCP (for example instructions= to override the default server instructions).

Returns:

Configured FastMCP instance with gitcode_api_tool registered.

register_mcp_gitcode_api_tool(mcp: FastMCP | Any, tool: GitCodeLLMTool | None = None) → Tool

Register the GitCode API tool with an existing FastMCP-compatible server.

Parameters:

  • mcp – FastMCP server instance.

  • tool – Optional preconfigured shared GitCode LLM tool.

Returns:

The registered tool callable.

register_mcp_help_resources(mcp: FastMCP | Any) → None

Register optional MCP resources that mirror gitcode_api_tool help text.

Registers:

  • gitcode-api://help — markdown index of per-op_type URIs.

  • gitcode-api://help/{op_type} — plain-text method list for one resource.

No-op when mcp does not expose FastMCP’s resource decorator.

Parameters:

mcp – FastMCP server instance (or compatible object).