Andy's Test API MCP Server

Exposes GitHub file read/write/delete operations through the Model Context Protocol, allowing LLM agents to directly manipulate repository contents without manual API integration. Implements MCP resource handlers that translate protocol requests into GitHub REST API calls, with automatic authentication via stored credentials and error propagation back through the MCP transport layer.

Automatically creates feature branches following Git conventions when an LLM agent initiates file modifications, with configurable naming patterns and automatic branch tracking. Uses MCP tool handlers to intercept file write operations, create branches via GitHub API, and maintain branch context throughout the agent session, ensuring all changes are isolated and Git history is preserved.

Provides full-text and semantic search across repository contents using indexed file metadata and content analysis, enabling LLM agents to locate relevant code files without scanning entire repositories. Implements search handlers that query GitHub's search API or local file indexing, with support for filtering by file type, language, and content patterns, returning ranked results with context snippets.

Implements multi-layer error handling that captures GitHub API errors, Git operation failures, and protocol-level issues, with automatic rollback capabilities and detailed error reporting. Uses MCP error handlers to catch failures at each operation stage, preserve Git history through atomic commits, and provide actionable error messages back to the agent, ensuring failed operations don't corrupt repository state.

Implements the Model Context Protocol server specification, exposing GitHub operations as standardized MCP resources and tools that any MCP-compatible client can invoke. Uses MCP's resource definition system to declare available operations (file read/write, branch creation, search), implements tool handlers for each operation, and manages the bidirectional message protocol between client and server, enabling seamless integration with Claude, custom agents, and other MCP clients.

Manages GitHub API authentication credentials (tokens, OAuth) with secure storage and automatic credential injection into API requests. Implements credential handlers that retrieve stored credentials at runtime, support multiple authentication methods (personal tokens, OAuth apps, GitHub Apps), and handle credential refresh/rotation, abstracting authentication complexity from the MCP client.