@jser/mcp

MCP-сервер для JSer.info

• Введение - Модель Контекстного Протокола

• modelcontextprotocol/typescript-sdk: официальный Typescript SDK для серверов и клиентов Model Context Protocol

Использование

Как использовать с VSCode

В VSCode вы можете использовать JSer.info MCP одним из двух способов:

Если вы используете удаленный сервер (рекомендуется)

Добавить удаленный сервер можно одним из следующих способов:

Метод 1: Добавить из командной строки

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

Метод 2: Добавить в settings.json

Добавьте следующее в файл настроек VSCode.json:

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

Это автоматически включит MCP JSer.info.

При использовании локального сервера

1. Запустите @jser/mcp в терминале

   npx @jser/mcp

2. Откройте палитру команд VSCode ( Cmd+Shift+P или Ctrl+Shift+P ) и запустите «MCP: Добавить сервер...»

3. Введите URL-адрес сервера http://localhost:14561/mcp для подключения.

Доступные функции

После подключения будут доступны следующие инструменты:

• jser_search_items : Поиск элементов по названию, описанию, URL и тегам (можно объединить несколько ключевых слов с помощью операции OR)

• jser_search_posts : Поиск сообщений по названию, описанию, URL, тегам

• jser_product_name : Получить название продукта из URL

• jser_week : Получить неделю JSer из числа

• jser_weeks : Получить все недели JSer

• jser_weeks_between : Получить количество недель JSer между двумя датами

• jser_week_with_item_url : Получить неделю JSer с элементом

• jser_item_with_item_url : Получить элемент JSer из URL

Доступные инструменты

В JSer.info MCP доступны следующие инструменты:

jser_search_items

Поиск элементов по названию, описанию, URL-адресу и тегам. Выполните поиск по нескольким ключевым словам, разделенным пробелами, с помощью оператора ИЛИ.

Параметры:

• query : Поисковый запрос (1-100 символов). ИЛИ выполните поиск по нескольким ключевым словам, разделенным пробелами

• limit : Максимальное количество возвращаемых результатов (1-100, по умолчанию: 10)

• offset : смещение результата (больше или равно 0, по умолчанию: 0)

• order : порядок сортировки

  • desc : Сначала новые (по умолчанию)

  • asc : Сначала самые старые

Возврат:

• Массив элементов

  • title : Название элемента.

  • url : URL-адрес элемента.

  • content : Описание товара

  • tags : Массив тегов

  • date : Дата и время регистрации

  • relatedLinks : Массив связанных ссылок

jser_search_posts

Поиск сообщений по названию, описанию, URL-адресу и тегам.

Параметры:

• query : Поисковый запрос (1-100 символов)

• limit : Максимальное количество возвращаемых результатов (1-100, по умолчанию: 10)

• offset : смещение результата (больше или равно 0, по умолчанию: 0)

• sort : порядок сортировки

  • relevance : порядок релевантности (по умолчанию)

  • date : По дате

• order : порядок сортировки

  • desc : Новейшие/Самые релевантные (по умолчанию)

  • asc : Сначала старые/Наименее релевантные

Возврат:

• Массив постов

  • title : Название поста

  • url : URL-адрес поста

  • content : Опубликовать контент

  • tags : Массив тегов

  • date : Дата и время публикации

jser_имя_продукта

Получите название продукта из URL.

Параметры:

• url : URL-адрес продукта (обязательно)

Возврат:

• Объект информации о продукте

  • name : Название продукта

  • url : URL-адрес продукта

  • releaseNoteProbability : Вероятность того, что это примечание к выпуску

  • releaseNoteVersion : Информация о версии примечания к выпуску (если применимо)

  • releaseNoteURL : URL-адрес примечаний к выпуску (если применимо)

jser_week

Получить неделю JSer из числа.

Параметры:

• number : номер недели JSer (обязательно)

Возврат:

• Объект недели JSer

  • number : номер недели JSer

  • startDate : дата начала

  • endDate : Дата окончания

  • items : список элементов на эту неделю

  • posts : Список постов за неделю

jser_weeks

Получить все недели JSer.

Возврат:

• Массив объектов недели JSer

  • number : номер недели JSer

  • startDate : дата начала

  • endDate : Дата окончания

  • items : список элементов на эту неделю

  • posts : Список постов за неделю

jser_weeks_between

Получает неделю JSer за указанный период.

Параметры:

• beginDate : дата начала периода (обязательно)

• endDate : Дата окончания периода (обязательно)

Возврат:

• Массив объектов недели JSer

  • number : номер недели JSer

  • startDate : дата начала

  • endDate : Дата окончания

  • items : список элементов на эту неделю

  • posts : Список постов за неделю

  • itemsCount : Количество элементов

  • postsCount : Количество сообщений

jser_week_with_item_url

Получает неделю JSer, содержащую элемент для указанного URL.

Параметры:

• item_url : URL-адрес элемента (обязательно)

Возврат:

• Объект недели JSer

  • number : номер недели JSer

  • startDate : дата начала

  • endDate : Дата окончания

  • items : список элементов на эту неделю

  • posts : Список постов за неделю

jser_item_with_item_url

Получает элемент по указанному URL.

Параметры:

• url : URL-адрес элемента (обязательно)

Возврат:

• Объект предмета

  • title : Название

  • url -адрес: URL-адрес

  • description : Описание

  • tags : Массив тегов

  • date : дата

  • relatedLinks : Массив связанных ссылок

Related MCP server: Documentation Search MCP Server

Источник

Используйте @jser/data-fetcher для получения данных

• Интервал сбора данных — повторный сбор данных через одну минуту после последнего выполнения.

• Другими словами, кэшированные данные используются в течение одной минуты.

Используйте DataSets для поиска

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

Используйте API JSer.info Product Name для поиска названий продуктов

$ 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

Логика извлечения данных использует @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`.

Журнал изменений

См. страницу релизов .

Проведение тестов

Установите devDependencies и запустите pnpm test :

pnpm test

Внося вклад

Запросы на включение внесенных изменений и звезды всегда приветствуются.

Для сообщений об ошибках и запросов на новые функции, пожалуйста, создайте задачу .

1. Давай!

2. Создайте ветку функций: git checkout -b my-new-feature

3. Зафиксируйте изменения: git commit -am 'Add some feature'

4. Отправить в ветку: git push origin my-new-feature

5. Отправьте запрос на извлечение :D

Автор

• azu: GitHub , Twitter

Лицензия

Массачусетский технологический институт © azu