PeeringDB Location Server

A Go-based MCP (Model Control Protocol) server that provides information about Internet Exchange (IX) locations for Autonomous System Numbers (ASNs) using the PeeringDB API.

Features

• Retrieves IX locations for any given ASN
• Shows operational status of each IX location
• Provides city information for each peering point
• Formatted output with emoji indicators for better readability

Prerequisites

• Go 1.x or higher
• Access to PeeringDB API
• The following Go packages:
  • github.com/mark3labs/mcp-go/mcp
  • github.com/mark3labs/mcp-go/server

Installation

1. Clone the repository
2. Install dependencies:

go mod download

Usage

The server provides a single tool called get_peering_locations that accepts an ASN as input and returns formatted information about all IX locations where that AS is present.

Example Response Format

🌐 IX Locations for AS64496:

1. Example IX
   📍 London
   Status: 🟢 Operational

2. Another IX
   📍 Frankfurt
   Status: 🔴 Not Operational

Status Indicators

• 🟢 Operational: The IX connection is active
• 🔴 Not Operational: The IX connection is currently down or inactive

API Integration

The server integrates with two PeeringDB API endpoints:

1. /api/net - Used to resolve ASN to PeeringDB network ID
2. /api/netixlan - Used to fetch IX location information

Error Handling

The server handles several error cases:

• Invalid ASN format
• ASN not found in PeeringDB
• API connection errors
• Invalid response data

Contributing

Contributions are welcome! Please ensure your code follows the existing structure and includes appropriate error handling.

Note

This tool requires access to the PeeringDB API. Please ensure you comply with PeeringDB's terms of service and API usage guidelines.

In Action