API-Dokumentation

Integrieren Sie MCP Hub über unsere REST-API. Greifen Sie mit Ihrem API key programmatisch auf Daten zu.

Authentifizierung

Holen Sie sich Ihren API key aus Ihrem Konto und verwenden Sie ihn, um Ihre Anfragen zu authentifizieren.

Authentifizierung ansehen

Endpunkte

Verwenden Sie unsere REST-API-Endpunkte, um MCP-Daten programmatisch zu durchsuchen und zu erkunden.

Endpunkte ansehen

Beispiele

Lernen Sie anhand von Codebeispielen und Dokumentation, wie Sie unsere API verwenden.

Beispiele ansehen

Cursor-Integration

Verwenden Sie MCP Hub direkt in Cursor IDE mit unserer MCP-Server-Integration.

Einrichtungsanleitung

Überblick

Unsere API bietet programmatischen Zugriff zum Durchsuchen und Erkunden von MCP-Daten. Sie können sie nutzen, um MCP-Informationen in Ihre Anwendungen zu integrieren.

Authentifizierung

Alle API-Endpunkte erfordern einen API key. Sie können Ihren API key auf der Seite API Keys erhalten.

API-Key-Verwendung

Fügen Sie Ihren API key im Authorization-Header ein:

Authorization: Bearer YOUR_API_KEY

Ratenbegrenzungen

Die API hat ein Ratenlimit von 20 Anfragen pro Stunde. Wenn Sie dieses Limit überschreiten, erhalten Sie eine 401-Unauthorized-Antwort.

Such-API

Endpunkt

GET /api/open/v1/search

Suchen Sie anhand von Schlüsselwörtern nach MCPs.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
keywords	string	Ja	Die zu suchenden Suchbegriffe

Beispielanfrage

GET /api/open/v1/search?keywords=blockchain
Authorization: Bearer YOUR_API_KEY

Beispielantwort

{
  "data": [
    {
      "name": "Blockchain Project",
      "brief": "A decentralized blockchain solution",
      "website_url": "https://example.com"
    }
  ],
  "count": 1
}

Fehlerantworten

Status	Beschreibung
400	Erforderliche Parameter fehlen
401	Ungültiger API key oder Ratenlimit überschritten
500	Serverfehler

MCP-API

MCP Hub stellt REST-API-Endpunkte zum Suchen und Abrufen von MCP-Informationen sowie einen mit dem Model Context Protocol (MCP) kompatiblen Server-Endpunkt bereit.

MCP-Protokollserver

POST/GET /api/open/mcp

Dieser Endpunkt stellt eine standardmäßige Model-Context-Protocol-(MCP-)Serverimplementierung bereit, die der JSON-RPC-2.0-Spezifikation entspricht und sowohl HTTP POST als auch Server-Sent Events (SSE) für die MCP-Such- und Detailabruffunktionen unterstützt.

MCP-Methoden

Methode	Beschreibung	Parameter
initialize	MCP-Verbindung initialisieren	Keine
tools/list	Verfügbare Tools auflisten	Keine
tools/call	search_mcp- oder get_mcp_detail-Tools aufrufen	name (string): Tool-Name arguments (object): Tool-Argumente

Beispiel: Verbindung initialisieren

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize"
}

Beispiel: MCPs suchen

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_mcp",
    "arguments": {
      "keywords": "blockchain",
      "limit": 10
    }
  }
}

Beispielantwort

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"success\": true, \"data\": [...], \"count\": 16}"
      }
    ]
  }
}

Beispiel: MCP-Details abrufen

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_mcp_detail",
    "arguments": {
      "mcp_id": "your-mcp-uuid"
    }
  }
}

SSE-Verbindung

GET /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Accept: text/event-stream

Cursor-IDE-Integration

MCP Hub kann über seine MCP-Serverkonfiguration einfach in Cursor IDE integriert werden. So können Sie MCPs direkt aus Ihrer Entwicklungsumgebung heraus durchsuchen und erkunden.

Konfigurationseinrichtung

Fügen Sie die folgende Konfiguration zu Ihrer Cursor-MCP-Einstellungsdatei hinzu (üblicherweise unter ~/.cursor/mcp.json):

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "YOUR_API_KEY_HERE",
        "Content-Type": "application/json"
      },
      "capabilities": {
        "tools": true
      }
    }
  }
}

Verwendung in Cursor

Nach der Konfiguration können Sie die MCP-Hub-Tools direkt in Ihren Cursor-Chat-Sitzungen verwenden:

Nach MCPs suchen

Bitten Sie Cursor, nach bestimmten MCPs zu suchen:

„Nach blockchain-bezogenen MCPs suchen“

„MCPs für Datenbankintegration finden“

„Zeig mir beliebte MCPs für Webentwicklung“

MCP-Details abrufen

Fordern Sie detaillierte Informationen zu bestimmten MCPs an:

„Details für MCP mit UUID: abc123… abrufen“

„Zeig mir mehr Informationen über das GitHub-MCP“

Verfügbare Tools

Die MCP-Hub-Integration stellt die folgenden Tools in Cursor bereit:

Tool	Beschreibung	Parameter
`search_mcp`	Nach MCPs anhand von Schlüsselwörtern suchen	keywords (string): Suchbegriffe limit (number, optional): maximale Anzahl an Ergebnissen (Standard: 50)
`get_mcp_detail`	Detaillierte Informationen zu einem bestimmten MCP abrufen	mcp_id (string): UUID des MCP

Fehlerbehebung

Verbindungsprobleme

Überprüfen Sie, ob Ihr API key korrekt und nicht abgelaufen ist
Prüfen Sie, ob die URL aus Ihrem Netzwerk erreichbar ist
Stellen Sie sicher, dass die Syntax der MCP-Konfigurationsdatei gültiges JSON ist

Ratenbegrenzung

API keys sind auf 20 Anfragen pro Stunde begrenzt
Wenn Sie das Ratenlimit erreichen, warten Sie auf das Zurücksetzen der Stunde