GitHub GraphQL API MCP

Instructions

Implementation Reference

• github_graphql_api_mcp_server.py:108-135 (handler)

  The handler function for the 'call_github_graphql' tool. It executes the GraphQL query against GitHub's API using the requests library, handles authentication via GITHUB_TOKEN environment variable, and returns the JSON response as a formatted string or an error message.

  @mcp.tool()
  def call_github_graphql(graphql: str) -> str:
      """A tool to execute GitHub GraphQL API queries. Before using, it's recommended to check the documentation first, and include ID fields in your queries for easier follow-up operations
      Args:
          graphql: The GraphQL query
      Returns:
          str: Execution result
      """
      try:
          # Set request headers including authorization
          headers = {
              "Content-Type": "application/json",
              "Accept": "application/json",
          }
          if GITHUB_TOKEN:
              headers["Authorization"] = f"Bearer {GITHUB_TOKEN}"
          # Send POST request
          response = requests.post(GITHUB_API_URL, headers=headers, json={'query': graphql})
  
          # Check response status
          if response.status_code == 200:
              # MCP tool output is expected to be a string; serialize JSON response.
              return json.dumps(response.json(), ensure_ascii=False)
          else:
              raise Exception(f"request failed: {response.status_code} - {response.text}")
      except Exception as e:
          return f"{e}."