GitHub Chat MCP

Instructions

Implementation Reference

• src/github_chat_mcp/server.py:16-43 (handler)

  The complete handler function for the 'index_repository' tool. It is registered via @mcp.tool() decorator, defines the input schema using Pydantic Field for repo_url, validates the URL, and sends a POST request to the GitHub Chat API's /verify endpoint to index the repository.

  @mcp.tool()
  def index_repository(
      repo_url: str = Field(
          description="The GitHub repository URL to index (format: https://github.com/username/repo)."
      ),
  ) -> str:
      """Index a GitHub repository to analyze its codebase. This must be done before asking questions about the repository."""
      try:
          if not repo_url:
              raise ValueError("Repository URL cannot be empty.")
          
          if not repo_url.startswith("https://github.com/"):
              raise ValueError("Repository URL must be in the format: https://github.com/username/repo")
          
          # Call the verify API endpoint
          response = requests.post(
              f"{GITHUB_CHAT_API_BASE}/verify",
              headers={"Content-Type": "application/json"},
              json={"repo_url": repo_url}
          )
          
          if response.status_code != 200:
              return f"Error indexing repository: {response.text}"
          
          return f"Successfully indexed repository: {repo_url}. You can now ask questions about this repository."
      
      except Exception as e:
          return f"Error: {str(e) or repr(e)}"