@limelink/mcp

한국어 · Dokumentation · Fähigkeiten-Referenz

Ein Model Context Protocol (MCP)-Server für die LimeLink-Verwaltung dynamischer Links. Erstellen, nachschlagen und verwalten Sie dynamische Links direkt aus Claude Code, Claude Desktop oder einem beliebigen MCP-kompatiblen Client.

Kein API-Schlüssel erforderlich, um loszulegen! Dokumentation und SDK-Setup-Anleitungen funktionieren ohne jegliche Konfiguration. Verbinden Sie sich einfach und erkunden Sie die LimeLink-Funktionen mit Ihrem KI-Assistenten.

Funktionen

• Dokumentationsressourcen — Zugriff auf die LimeLink-Dokumentation (15 Seiten + Index) direkt von Ihrem KI-Assistenten — kein API-Schlüssel erforderlich

• 5 Tools — Profile und Projekte entdecken, dynamische Links erstellen und Links nachschlagen (API-Tools erfordern ein konfiguriertes Profil)

• In-Memory-Caching — 1-Stunden-TTL-Cache für Dokumentationsabrufe

Laufzeit

• Node.js 18 oder höher

• Nur stdio-Transport; Remote-MCP/HTTP-Transport wird nicht unterstützt

• npm-Paket: @limelink/mcp; globale ausführbare Datei: limelink-mcp

• stdout ist für das MCP-Protokoll reserviert; Diagnose- und Wrapper-Logs müssen stderr verwenden

Siehe Installation und Konfiguration und Netzwerkverhalten für den vollständigen Betriebsvertrag.

Was funktioniert ohne API-Schlüssel?

Related MCP server: lynxprompt-mcp

Schnellstart

Ohne API-Schlüssel (Dokumentation & Anleitungen)

Kein API-Schlüssel erforderlich. Verbinden Sie sich und erkunden Sie sofort die LimeLink-Dokumentation und Setup-Anleitungen:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"]
    }
  }
}

Fragen Sie Ihren KI-Assistenten zum Beispiel:

• "Lies die LimeLink-Erste-Schritte-Dokumentation"

• "Wie richte ich Deep Linking für iOS ein?"

• "Zeig mir den LimeLink-SDK-Integrationsleitfaden"

Mit Organisationsprofilen (Vollständige Funktionen)

Erstellen Sie die unten gezeigte Profildatei der Version 1 und geben Sie ihren absoluten Pfad an:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Verwendung mit globaler Installation

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Konfiguration

Claude Code

Der einfachste Weg, den MCP-Server hinzuzufügen, ist der Befehl claude mcp add:

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

Gültigkeitsbereich-Optionen:

• --scope user — In allen Projekten verfügbar

• --scope project — In .mcp.json gespeichert (über Git mit dem Team teilbar)

Claude Desktop & andere MCP-Clients

Fügen Sie die JSON-Konfiguration zur Konfigurationsdatei Ihres Clients hinzu:

Profildatei

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

Umgebungsvariablen

LIMELINK_API_KEY und LIMELINK_PROJECT_ID werden ignoriert. Wenn kein Anmeldedatenprofil konfiguriert ist, leiten API-gestützte Tools den Agenten an Organisationen, um einen Organisations-API-Schlüssel auszustellen und die Profildatei zu konfigurieren. Projektgestützte Tools akzeptieren eine Projekt-UUID direkt. Eine optionale projects-Zuordnung eines Profils ist eine empfohlene Annehmlichkeit für häufig verwendete Projekte, keine Voraussetzung; fügen Sie Aliase nach der list-projects-Erkennung hinzu, falls nützlich. Profile initialisieren lazy durch Anmeldedaten-Introspection beim ersten API-gestützten Aufruf. Änderungen an der Profildatei, einschließlich Alias-Ergänzungen, erfordern einen Neustart des MCP-Servers.

Sie können Ihren API-Schlüssel aus dem LimeLink-Dashboard erhalten. Ohne API-Schlüssel sind Dokumentationsressourcen und SDK-Setup-Anleitungen vollständig verfügbar.

Tools

list-profiles

Listet konfigurierte Aliase, Organisationsbezeichnungen, Standardstatus und aktuellen Initialisierungsstatus auf, ohne die API zu kontaktieren. Bereits initialisierte Profile enthalten Bereiche. API-Schlüsselwerte bleiben geheim und werden nie zurückgegeben. Organisations-, Projekt-, Benutzerdefinierte-Domain- und Anmeldedaten-Identifikatoren sowie Schlüsselpräfixe sind nicht geheime Identifikatoren und können in API-gestützten Tool-Antworten erscheinen, wenn nützlich.

list-projects

Listet Projekte in der Organisation auf, die aus den Anmeldedaten des ausgewählten Profils ermittelt werden. Akzeptiert optional profile; die Anmeldedaten erfordern projects:read.

list-custom-domains

Listet benutzerdefinierte Domains für das erforderliche project (Alias oder UUID) auf. Akzeptiert optional profile; die Anmeldedaten erfordern domains:read.

create-link

Erstellt einen V2-Core-Link mit plattformspezifischem Deep Linking, Auswahl benutzerdefinierter Domains, Social Previews und UTM-Tracking.

Parameter:

Beispielverwendung in Claude:

"Erstelle einen dynamischen Link für https://example.com/product/123 mit dem Suffix 'product-123' und aktiviere Analysen"

get-link-by-suffix

Sucht einen dynamischen Link anhand seines Suffixes nach.

get-link-by-url

Löst einen Link über die V2-API anhand seiner vollständigen URL auf. Das Backend bestimmt, ob die URL zu einem kostenlosen Standard-Namespace, einem Projekt-Hostnamen oder einer aktiven benutzerdefinierten Domain gehört. Kein Projekt-Selektor oder lokale Suffix-Analyse erforderlich.

Die URL muss eine absolute HTTPS-URL mit genau einem /{suffix}-Pfadsegment und ohne Query, Fragment, expliziten Port oder Anmeldedaten sein.

Ressourcen

limelink://docs/index

Gibt den vollständigen LimeLink-Dokumentationsindex (llms.txt) zurück.

limelink://docs/{slug}

Gibt einzelne Dokumentationsseiten zurück. Verfügbare Slugs:

introduction, getting-started, project, application, dynamic-link, create-link, link-detail, link-management, appearance, sdk-integration, ios-sdk, android-sdk, api-integration, advanced, llm-agent

Beispielverwendung in Claude:

"Lies die LimeLink-API-Integrationsdokumentation"

Claude greift auf limelink://docs/api-integration zu

Entwicklung

Voraussetzungen

• Node.js >= 18

• pnpm

Einrichtung

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

Lokal ausführen

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

Testen

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

Projektstruktur

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

Lizenz

MIT