Skip to content

feat(mcp): expose CodeIndexSDK as an MCP server for external code assistants #869

@itomek

Description

@itomek

Context

Reviewer on #721 suggested a GAIA code-index MCP server would let Claude Code, Cursor, and other external code assistants use GAIA's semantic search over the gaia codebase during development.

Goal

Wrap CodeIndexSDK behind an MCP server under src/gaia/mcp/servers/code_index/ exposing:

  • search_code(query, scope, top_k)
  • get_index_status()
  • rebuild_index(max_files, model)

Acceptance

  • Server registered via gaia mcp add flow and listed by gaia mcp list.
  • Documented in docs/sdk/infrastructure/mcp.mdx.
  • Claude Code in the amd/gaia repo can call search_code("how does authentication work") and get ranked results.
  • Unit + MCP integration tests under tests/mcp/.

References

  • src/gaia/mcp/ — MCP bridge and existing servers
  • src/gaia/code_index/sdk.py — SDK to wrap
  • docs/sdk/infrastructure/mcp.mdx — docs target

Deferred from #721.

Metadata

Metadata

Assignees

No one assigned

    Labels

    code-agentCode agent changesdomain:integrationsMCP catalogue, connectors, OAuth, third-party APIsenhancementNew feature or requestmcpMCP integration changestrack:consumer-appHermes-competitor consumer product — mobile-first, voice + messaging + memory + skills

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions