@jser/mcp

Ein MCP-Server für JSer.info

• Einführung - Model Context Protocol

• modelcontextprotocol/typescript-sdk: Das offizielle Typescript SDK für Model Context Protocol-Server und -Clients

Verwendung

Verwendung mit VSCode

In VSCode können Sie das JSer.info MCP auf zwei Arten verwenden:

Wenn Sie einen Remote-Server verwenden (empfohlen)

Sie können einen Remote-Server auf eine der folgenden Arten hinzufügen:

Methode 1: Von der Befehlszeile hinzufügen

code --add-mcp '{"name":"jser-info-mcp","url":"https://mcp.jser.info/mcp"}'

Methode 2: Zu settings.json hinzufügen

Fügen Sie Ihrer VSCode-Datei „settings.json“ Folgendes hinzu:

"mcp": {
  "servers": {
    "jser-info-mcp": {
      "url": "https://mcp.jser.info/mcp"
    }
  }
}

Dadurch wird das JSer.info MCP automatisch aktiviert.

Bei Verwendung eines lokalen Servers

1. Starten Sie @jser/mcp im Terminal

   npx @jser/mcp

2. Öffnen Sie die VSCode-Befehlspalette ( Cmd+Shift+P oder Ctrl+Shift+P ) und führen Sie „MCP: Server hinzufügen …“ aus.

3. Geben Sie zum Verbinden http://localhost:14561/mcp als Server-URL ein.

Verfügbare Funktionen

Sobald die Verbindung hergestellt ist, stehen die folgenden Tools zur Verfügung:

• jser_search_items : Elemente nach Titel, Beschreibung, URL und Tags suchen (mehrere Schlüsselwörter können mit ODER verknüpft werden)

• jser_search_posts : Beiträge nach Titel, Beschreibung, URL, Tags durchsuchen

• jser_product_name : Holen Sie sich den Produktnamen aus der URL

• jser_week : Ruft die JSer-Woche aus einer Zahl ab

• jser_weeks : Alle JSer-Wochen abrufen

• jser_weeks_between : Ruft die Anzahl der JSer-Wochen zwischen zwei Daten ab

• jser_week_with_item_url : Holen Sie sich die JSer-Woche mit einem Artikel

• jser_item_with_item_url : Holen Sie sich ein JSer-Element von einer URL

Verfügbare Werkzeuge

Die folgenden Tools sind in JSer.info MCP verfügbar:

jser_search_items

Suchen Sie nach Artikeln nach Titel, Beschreibung, URL und Tags. Führen Sie eine ODER-Suche nach mehreren durch Leerzeichen getrennten Schlüsselwörtern durch.

Parameter:

• query : Suchanfrage (1–100 Zeichen). ODER suchen Sie nach mehreren durch Leerzeichen getrennten Schlüsselwörtern

• limit : Maximale Anzahl der zurückzugebenden Ergebnisse (1-100, Standard: 10)

• offset : der Offset des Ergebnisses (größer oder gleich 0, Standard: 0)

• order : Sortierreihenfolge

  • desc : Neueste zuerst (Standard)

  • asc : Älteste zuerst

Widerrufsfolgen:

• Eine Reihe von Elementen

  • title : Der Titel des Artikels.

  • url : Die URL des Elements.

  • content : Artikelbeschreibung

  • tags : Ein Array von Tags

  • date : Datum und Uhrzeit der Registrierung

  • relatedLinks : Ein Array verwandter Links

jser_search_posts

Durchsuchen Sie Beiträge nach Titel, Beschreibung, URL und Tags.

Parameter:

• query : Suchanfrage (1-100 Zeichen)

• limit : Maximale Anzahl der zurückzugebenden Ergebnisse (1-100, Standard: 10)

• offset : der Offset des Ergebnisses (größer oder gleich 0, Standard: 0)

• sort : Sortierreihenfolge

  • relevance : Relevanzreihenfolge (Standard)

  • date : Nach Datum

• order : Sortierreihenfolge

  • desc : Neueste/Relevanteste (Standard)

  • asc : Älteste zuerst/Am wenigsten relevant

Widerrufsfolgen:

• Eine Reihe von Beiträgen

  • title : Der Titel des Beitrags

  • url : Die URL des Beitrags

  • content : Inhalt veröffentlichen

  • tags : Ein Array von Tags

  • date : Datum und Uhrzeit der Veröffentlichung

jser_produktname

Den Produktnamen entnehmen Sie der URL.

Parameter:

• url : Produkt-URL (erforderlich)

Widerrufsfolgen:

• Produktinformationsobjekt

  • name : Produktname

  • url : Produkt-URL

  • releaseNoteProbability : Wahrscheinlichkeit, dass es sich um eine Versionsnotiz handelt

  • releaseNoteVersion : Versionsinformationen zur Versionsinformation (falls zutreffend)

  • releaseNoteURL : Die URL der Versionshinweise (falls zutreffend)

jser_woche

Holen Sie sich die JSer-Woche aus der Nummer.

Parameter:

• number : JSer-Wochennummer (erforderlich)

Widerrufsfolgen:

• JSer-Wochenobjekt

  • number : JSer-Wochennummer

  • startDate : Startdatum

  • endDate : Enddatum

  • items : Die Liste der Artikel für diese Woche

  • posts : Liste der Beiträge für die Woche

jser_weeks

Holen Sie sich alle JSer-Wochen.

Widerrufsfolgen:

• Ein Array von JSer-Wochenobjekten

  • number : JSer-Wochennummer

  • startDate : Startdatum

  • endDate : Enddatum

  • items : Die Liste der Artikel für diese Woche

  • posts : Liste der Beiträge für die Woche

jser_weeks_between

Ruft die JSer-Woche für den angegebenen Zeitraum ab.

Parameter:

• beginDate : Das Startdatum des Zeitraums (erforderlich)

• endDate : Enddatum des Zeitraums (erforderlich)

Widerrufsfolgen:

• Ein Array von JSer-Wochenobjekten

  • number : JSer-Wochennummer

  • startDate : Startdatum

  • endDate : Enddatum

  • items : Die Liste der Artikel für diese Woche

  • posts : Liste der Beiträge für die Woche

  • itemsCount : Anzahl der Artikel

  • postsCount : Anzahl der Beiträge

jser_week_with_item_url

Ruft die JSer-Woche ab, die das Element für die angegebene URL enthält.

Parameter:

• item_url : Artikel-URL (erforderlich)

Widerrufsfolgen:

• JSer-Wochenobjekt

  • number : JSer-Wochennummer

  • startDate : Startdatum

  • endDate : Enddatum

  • items : Die Liste der Artikel für diese Woche

  • posts : Liste der Beiträge für die Woche

jser_item_with_item_url

Ruft das Element unter der angegebenen URL ab.

Parameter:

• url : Die URL des Artikels (erforderlich)

Widerrufsfolgen:

• Item-Objekt

  • title : Titel

  • url : URL

  • description : Beschreibung

  • tags : Ein Array von Tags

  • date : Datum

  • relatedLinks : Ein Array verwandter Links

Related MCP server: Documentation Search MCP Server

Quelle

Verwenden Sie @jser/data-fetcher , um Daten abzurufen

• Das Intervall für die Datenerfassung beträgt eine Minute nach der letzten Ausführung eine erneute Datenerfassung.

• Mit anderen Worten: Zwischengespeicherte Daten werden eine Minute lang verwendet.

Verwenden von DataSets für Suchvorgänge

Item: 紹介するサイトのこと
    1 Item = 1 サイト
    すべてのデータのoriginとなるものです
    サイトごとにタイトル、URL、登録した日付、タグなどが含まれています
    API: https://jser.info/source-data/items.json
Post: JSer.infoに投稿される記事のこと
    1 Post = 1 記事
    それぞれの記事のタイトル、URL、タグ、日付などが含まれます
    @jser/statを使うことでItemとPostを元に指定したサイトが紹介された記事を検索できます
    API: https://jser.info/posts.json
Post Item: JSer.infoに投稿された記事中のItem(サイト)のこと
    1 Post Item = 1 サイト
    基本的にはItemと同じだが、Post ItemはPost(記事)におけるカテゴリ（ヘッドラインなど）が含まれます
    カテゴリの種類は @jser/post-parser を参照してください
    Itemを元に投稿時に編集している場合などもあるため、ItemとPost Itemは必ずしも一致するわけではありません
    制限: カテゴリ区別が付けられたのは2014-08-03からであるため、それ以前のデータは含まれない
    Postにはすべての記事は含まれるがPost Itemのデータは含まれていない
    API: https://jser.info/public/data/post-details.json

Verwenden Sie die JSer.info Product Name API , um nach Produktnamen zu suchen

$ curl "https://jser-product-name.deno.dev/?url=https://deno.com/blog/v1.19"
{"name":"Deno","url":"https://deno.com","releaseNoteProbability":0.7619047619047619,"releaseNoteVersion":"v1.19"}
$ curl "https://jser-product-name.deno.dev/?url=https://example.com"
null # status code is 400

Die Datenextraktionslogik verwendet @jser/stat .

### findItemsBetween(beginDate, endDate): JSerItem[]

return JSerItems between two dates

### getJSerWeeks(): JSerWeek[]

return all JSerWeeks

### findJSerWeeksBetween(beginDate, endDate):  JSerWeek[]

return JSerWeeks between two dates

### findJSerWeek(number): JSerWeek

number start with 1.

return JSerWeek at the number.

### findWeekWithItem(itemObject): JSerWeek

return JSerWeek contain the itemObject.

### findItemWithURL(URL): JSerItem

return JSerItem match the `URL`.

Änderungsprotokoll

Siehe Seite „Veröffentlichungen“ .

Ausführen von Tests

Installieren Sie devDependencies und führen Sie pnpm test aus:

pnpm test

Beitragen

Pull Requests und Sterne sind immer willkommen.

Bei Fehlern und Funktionsanfragen erstellen Sie bitte ein Problem .

1. Gabel es!

2. Erstellen Sie Ihren Feature-Zweig: git checkout -b my-new-feature

3. Übernehmen Sie Ihre Änderungen: git commit -am 'Add some feature'

4. Pushen zum Zweig: git push origin my-new-feature

5. Senden Sie eine Pull-Anfrage :D

Autor

• azu: GitHub , Twitter

Lizenz

MIT © azu