@jser/mcp

Un servidor MCP para JSer.info

• Introducción - Protocolo de Contexto Modelo

• modelcontextprotocol/typescript-sdk: El SDK oficial de Typescript para servidores y clientes del Protocolo de Contexto de Modelo

Uso

Cómo usarlo con VSCode

En VSCode, puedes usar el MCP JSer.info de una de dos maneras:

Si utiliza un servidor remoto (recomendado)

Puede agregar un servidor remoto de una de las siguientes maneras:

Método 1: Agregar desde la línea de comandos

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

Método 2: Agregar a settings.json

Agregue lo siguiente a su archivo settings.json de VSCode:

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

Esto habilitará automáticamente el MCP JSer.info.

Al utilizar un servidor local

1. Inicie @jser/mcp en la terminal

   npx @jser/mcp

2. Abra la paleta de comandos de VSCode ( Cmd+Shift+P o Ctrl+Shift+P ) y ejecute "MCP: Agregar servidor..."

3. Introduzca la URL del servidor http://localhost:14561/mcp para conectarse.

Funciones disponibles

Una vez conectado, estarán disponibles las siguientes herramientas:

• jser_search_items : busca elementos por título, descripción, URL y etiquetas (se pueden usar OR con varias palabras clave)

• jser_search_posts : busca publicaciones por título, descripción, URL y etiquetas

• jser_product_name : Obtener el nombre del producto de la URL

• jser_week : Obtener la semana de JSer a partir de un número

• jser_weeks : Obtener todas las semanas de JSer

• jser_weeks_between : Obtiene el número de semanas JSer entre dos fechas

• jser_week_with_item_url : Obtener la semana de JSer con un artículo

• jser_item_with_item_url : Obtener un elemento JSer desde una URL

Herramientas disponibles

Las siguientes herramientas están disponibles en JSer.info MCP:

elementos de búsqueda jser

Busque artículos por título, descripción, URL y etiquetas. Realice una búsqueda OR de varias palabras clave separadas por espacios.

Parámetros:

• query : Consulta de búsqueda (1-100 caracteres). O busque varias palabras clave separadas por espacios

• limit : Número máximo de resultados a devolver (1-100, predeterminado: 10)

• offset : el desplazamiento del resultado (mayor o igual a 0, predeterminado: 0)

• order : orden de clasificación

  • desc : Lo más nuevo primero (predeterminado)

  • asc : Más antiguo primero

Devoluciones:

• Una variedad de artículos

  • title : el título del artículo.

  • url : La URL del artículo.

  • content : Descripción del artículo

  • tags : una matriz de etiquetas

  • date : Fecha y hora de registro

  • relatedLinks : Una serie de enlaces relacionados

jser_search_posts

Busque publicaciones por título, descripción, URL y etiquetas.

Parámetros:

• query : Consulta de búsqueda (1-100 caracteres)

• limit : Número máximo de resultados a devolver (1-100, predeterminado: 10)

• offset : el desplazamiento del resultado (mayor o igual a 0, predeterminado: 0)

• sort : orden de clasificación

  • relevance : relevancia (predeterminado)

  • date : Por fecha

• order : orden de clasificación

  • desc : Más reciente/Más relevante (predeterminado)

  • asc : Más antiguo primero/Menos relevante

Devoluciones:

• Una serie de publicaciones

  • title : El título de la publicación

  • url : La URL de la publicación

  • content : Contenido de la publicación

  • tags : una matriz de etiquetas

  • date : Fecha y hora de publicación

jser_nombre_del_producto

Obtenga el nombre del producto de la URL.

Parámetros:

• url : URL del producto (obligatorio)

Devoluciones:

• Objeto de información del producto

  • name : Nombre del producto

  • url : URL del producto

  • releaseNoteProbability : Probabilidad de que sea una nota de lanzamiento

  • releaseNoteVersion : Información de la versión de la nota de lanzamiento (si corresponde)

  • releaseNoteURL : La URL de las notas de la versión (si corresponde)

jser_week

Obtenga JSer semana a partir del número.

Parámetros:

• number : número de semana de JSer (obligatorio)

Devoluciones:

• Objeto de la semana de JSer

  • number : número de semana de JSer

  • startDate : fecha de inicio

  • endDate : Fecha de finalización

  • items : La lista de artículos para esa semana

  • posts : Lista de publicaciones de la semana

jser_semanas

Obtenga todas las semanas de JSer.

Devoluciones:

• Una matriz de objetos de semana de JSer

  • number : número de semana de JSer

  • startDate : fecha de inicio

  • endDate : Fecha de finalización

  • items : La lista de artículos para esa semana

  • posts : Lista de publicaciones de la semana

jser_semanas_entre

Obtiene la semana de JSer para el período especificado.

Parámetros:

• beginDate : La fecha de inicio del período (obligatorio)

• endDate : Fecha de finalización del periodo (obligatorio)

Devoluciones:

• Una matriz de objetos de semana de JSer

  • number : número de semana de JSer

  • startDate : fecha de inicio

  • endDate : Fecha de finalización

  • items : La lista de artículos para esa semana

  • posts : Lista de publicaciones de la semana

  • itemsCount : Número de artículos

  • postsCount : Número de publicaciones

jser_week_con_url_del_artículo

Obtiene la semana JSer que contiene el elemento para la URL especificada.

Parámetros:

• item_url : URL del artículo (obligatorio)

Devoluciones:

• Objeto de la semana de JSer

  • number : número de semana de JSer

  • startDate : fecha de inicio

  • endDate : Fecha de finalización

  • items : La lista de artículos para esa semana

  • posts : Lista de publicaciones de la semana

jser_item_con_url_del_artículo

Obtiene el elemento en la URL especificada.

Parámetros:

• url : La URL del artículo (obligatorio)

Devoluciones:

• Objeto de artículo

  • title : Título

  • url : URL

  • description : Descripción

  • tags : una matriz de etiquetas

  • date : fecha

  • relatedLinks : Una serie de enlaces relacionados

Related MCP server: Documentation Search MCP Server

Fuente

Utilice @jser/data-fetcher para obtener datos

• El intervalo para la adquisición de datos es volver a adquirir datos un minuto después de la última ejecución.

• En otras palabras, los datos almacenados en caché se utilizan durante un minuto.

Utilice conjuntos de datos para búsquedas

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

Utilice la API de nombre de producto de JSer.info para buscar nombres de productos

$ 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

La lógica de extracción de datos utiliza @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`.

Registro de cambios

Ver página de lanzamientos .

Ejecución de pruebas

Instalar devDependencies y ejecutar pnpm test :

pnpm test

Contribuyendo

Las solicitudes de extracción y las estrellas siempre son bienvenidas.

Para errores y solicitudes de funciones, cree un problema .

1. ¡Bifurcalo!

2. Crea tu rama de funciones: git checkout -b my-new-feature

3. Confirme sus cambios: git commit -am 'Add some feature'

4. Empujar a la rama: git push origin my-new-feature

5. Enviar una solicitud de extracción :D

Autor

• azu: GitHub , Twitter

Licencia

MIT © azu