CiteWire

citewire.org · Openly Useful

Attributionsorientierte MCP-Infrastruktur für das Auffinden von Nachrichten und Forschung.

CiteWire bietet Agenten einen strukturierten, schreibgeschützten Zugriff auf Nachrichten- und Forschungsmetadaten und bewahrt dabei die Quellenangabe und den Traffic des ursprünglichen Herausgebers. Es kann eine kompatible Nachrichtenplattform als typisierte MCP-Tools verfügbar machen, optionale öffentliche Provider-APIs abfragen oder beides in einem Server kombinieren.

Die Community-Edition ist für sich allein nützlich. Sie enthält den MCP-Kern, die stdio- und HTTP-Transporte, den generischen Plattform-Adapter sowie jeden Provider-Adapter in diesem Repository unter der MIT-Lizenz. Die kommerzielle Produktausrichtung ist additiv und konzentriert sich auf verwaltete Abläufe, Personalisierung, Workflows, Zusammenarbeit, gespeicherte Verläufe und Support. Siehe Produktstufen.

Wofür CiteWire gedacht ist

• Betreiber von Nachrichtenplattformen können eine kompatible Lese-API über news.list, news.get, news.topics und news.about verfügstellen.

• Forschende und Agenten-Entwickler kann die öffentlichen Nachrichten- und Forschungsprovider aktiviert, die sie abfragen möchten.

• Self-Hoster können denselben Server über stdio, zustandsloses HTTP oder in einer Node-Serverless-Funktion ausführen.

• Provider-Mitwirkende können einen fokussierten Adapter hinzufügen, ohne eine Laufzeitabhängigkeit einzuführen.

CiteWire ist kein Volltext-Erfassungsdienst, Crawler, Publisher, Redaktionssystem oder Rechteklärungsservice. Es speichert keine Artikeltexte und veröffentlicht keine Artikeltexte erneut. Die Erreichbarkeit eines Providers ersetzt nicht die Prüfung der aktuellen Bedingungen des Providers für Ihren Anwendungsfall.

Related MCP server: agentpulse-mcp

Schnellstart

Voraussetzungen: Node.js 18 oder neuer. Community ist ein ESM-only-Node-Paket; es bietet keinen CommonJS-Einstiegspunkt.

Erstellen Sie citewire.config.json mit einem aktivierten Provider:

{
  "providers": {
    "openalex": { "enabled": true }
  }
}

Führen Sie den Server über stdio aus:

npx -y citewire --config citewire.config.json

stdio ist der Standardtransport und die übliche Wahl, wenn ein MCP-Client CiteWire als lokalen Prozess startet.

MCP-Client-Konfiguration

Verwenden Sie einen absoluten Konfigurationspfad, da Clients nicht immer aus dem Projektverzeichnis gestartet werden:

{
  "mcpServers": {
    "citewire": {
      "command": "npx",
      "args": [
        "-y",
        "citewire",
        "--config",
        "/absolute/path/to/citewire.config.json"
      ]
    }
  }
}

HTTP-Transport

Führen Sie den zustandslosen HTTP-Transport auf Port 8722 aus:

npx -y citewire --config citewire.config.json --http 8722

Der lokale Endpunkt akzeptiert JSON-RPC über POST /. Er bietet keine Sitzungen oder einen Ereignisstream.

Zwei Einsatzmöglichkeiten

1. Eine kompatible Nachrichtenplattform anbinden

Deklarieren Sie eine Plattform mit Anzeigenamen, Website-URL und Lese-API-Basis:

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  }
}

Diese Konfiguration macht vier Tools verfügbar:

Die erforderliche HTTP-Oberfläche ist im Plattform-Lese-API-Vertrag dokumentiert.

2. Öffentliche Provider-Tools aktivieren

Provider-Adapter sind in Community enthalten und standardmäßig deaktiviert. Ein Provider wird nur aktiv, wenn enabled in seinem Konfigurationseintrag auf true steht.

{
  "providers": {
    "gdelt-doc": { "enabled": true },
    "arxiv": { "enabled": true },
    "crossref": {
      "enabled": true,
      "mailto": "operator@example.com"
    }
  }
}

Crossref verlangt die eigene Kontakt-E-Mail-Adresse des Deployers, damit der Betreiber gegenüber dem höflichen Pool von Crossref identifiziert werden kann. CiteWire sendet diese Adresse ausschließlich an Crossref in ein mailto-Parameter und den User-Agent. Kopieren Sie die Beispieladresse nicht.

Die aktuellen Adapter sind:

Lesen Sie vor der Aktivierung die Provider. Dieses Dokument erfasst für jeden Adapter den Endpunkt, die Dokumentation, die Datenbasis ohne Bezahlung und die bekannten Anstrengungen/Höflichkeitslimits. Die eigene Dokumentation des Anbieters bleibt Quelle der Wahrheit.

Konfigurationsverhalten

• platform ist optional.

• providers ist optional.

• Ein Provider, der in der Konfiguration fehlt, bleibt deaktiviert.

• Eine leere Konfiguration ist gültig und legt keine Tools aus.

• Eine ungültige Konfiguration verhindert beim Start den Start und benennt das Feld in der Fehlermeldung.

• tools/list bleibt die maßgebliche Tool-Liste für die laufende Bereitstellung. (kein )

Eine Bereitstellung kann Plattform- und Provider-Werkzeuge kombinieren:

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  },
  "providers": {
    "openalex": { "enabled": true }
  }
}

Optionale Community-Grundlage für Richtlinien

CiteWire kann eine lokale, read-only Grundlage für Quellenrichtlinien, Rechtebewertung und Shadow-Inklusion-Scoring bereitstellen:

{
  "community": {
    "enabled": true,
    "classifierMode": "shadow",
    "thresholds": {
      "adjacent_min": 0.5,
      "standard_min": 0.6
    }
  }
}

Jede mitgelieferte Quelle bleibt standardmäßig deaktiviert. Diese Einstellung führt keine Netzwerkaufrufe aus, lädt keine Zugangsdaten und kann nicht veröffentbart. Anmeldeinformationen-basierte Rechteprüfungen akzeptieren Breathing theatre? Akzeptieren Sie opaque geere Verweise? Let’s translate. "Credential-based rights checks accept opaque secret-manager references in memory but never return those references." -> "Credential-basierte Rechteprüfungen akzeptieren undurchsichtige Kennwortspeicher-Referenzen im Speicher, geben sie aber nie zurück." Re-read above – actually I will write it correctly.

Der Klassifikator wird in den Schatten-Modus gezwungen und meldet stets publishable: false, bis ein separat geprüftes Redaktionssystem und ein Bewertungskorpus vorhanden sind.

Lesen Sie Quellen-Registry und Rechte für die Laufzeitvalidierung, Fail-Closed-Policy, kanonische MCP-Tools und -Ressourcen sowie die aktuellen Einschränkungen.

Design-Grenzen

• MIT und keine Abhängigkeiten. Das Paket verwendet Node-Built-ins und hat keine Laufzeit- oder Entwicklungsabhängigkeiten.

• Node-ESM. Community unterstützt Node.js 18 und neuer über ESM. Es ist nicht CommonJS-kompatibel oder -Build.

• Reine Lese. Die enthaltenen Tools fragen Leseoberflächen für Plattform und Provider ab.

• Zustandslos. Der Community-Server hat keine Konten, Sitzungen, gespeicherten Suche, keine gespeische Verlaufgespeicherte.

• Attribution first. Ergebnisse bewahren die Quelle undVerweise, die die vorgelagerte Plattform oder Provider.

zurückliefern.

• Konfigurationsgetrieben. Ein Deployer entscheidet, welche Tools vorhanden sind. Nichts aktiviert sich selbst.

• Speicherfrei. Der Kern speichert keine Provider-Antworten oder Quelleninhalte.

Diese Grenzen werden über die Projekt-Governance-Richtlinie erhalten.

Ökosystem- und Produktdokumentation

• Produktstufen definiert den dauerhaften Community-Wert eine additive kommerzierte.

• Distribution enthält die exakte Registry- und Katalog-Liste. Nicht durchgeführte Veröffentlichunge werden mit PENDING markiert.

• Governance erklärt Entscheid, Provider-Betreuung, Kompatibilität und Lizenzierung.

• Anbieter dokumentiert jeden zugrunde liegenden Provider.

• Plattformvertrag definiert die kompatible Nachrichten-Lese-API.

• Mitwirken umfasst Setup, Tests, Provider-Hinzufügungen und Pull-Request-Erwartungen.

• Releasing definiert Paket- und Registry-Release-Kontrollen.

• Support, Sicherheit und Code of Conduct definieren die Kommunikationskanal der Community.

Projektursprung

CiteWire wurde durch die eigeste Einsatz für Karaya Group Industry News geprägt. Der öffentliche Plattformvertrag ist generisch und kann jede kompatible Lese-API kapseln.

Mitwirken

Führen Sie die Testsuite mit npm test aus. Es ist keine Installationsschritt erforderlich. Siehe CONTRIBUTING.md, bevor Sie einen Provider-oder eine Vertragsänderung vorschlagen.

Lizenz

Community ist unter der MIT-Lizenz verfügbar. Siehe LICENSE.