mcpField
@
@jser/mcp

@jser/mcp

ローカル
github.com/jser開発ツール2277 週間前に更新
リポジトリ

@jser/mcp について

@jser/mcp は JSer.info 向けの MCP サーバーで、JavaScript 関連サイトや投稿を収録するデータを AI クライアントから検索できます。JavaScript の最新情報を追う開発者に向いており、リモートサーバーとしても、ローカルでも利用できます。

主な機能

  1. 01アイテムと投稿のキーワード検索
  2. 02URL からのプロダクト名とリリースノート情報の取得
  3. 03番号や日付範囲による JSer 週の取得
  4. 04URL に対応する週やアイテムの検索

活用シーン

  1. 01VSCode から MCP 経由で JSer 掲載のツールや記事を検索
  2. 02プロダクトのリリースノートとバージョンの確認
  3. 03日付範囲を指定した JSer 週刊情報の一覧化

MCP 対応

MCP サーバーとして jser_search_items、jser_search_posts など 8 つのツールを MCP クライアントに公開します。リモートサーバー https://mcp.jser.info/mcp として接続するか、npx でローカル起動して利用できます。

#mcp#jser

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "jser": {
      "command": "npx",
      "args": [
        "-y",
        "@jser/mcp"
      ]
    }
  }
}
起動コマンドnpx -y @jser/mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@jser/mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

@jser/mcp

An MCP Server for JSer.info

Usage

VSCodeでの使い方

VSCodeでは、次のいずれかの方法でJSer.info MCPを利用できます：

リモートサーバーを利用する場合（推奨）

以下のいずれかの方法でリモートサーバーを追加できます：

方法1: コマンドラインから追加
code --add-mcp '{"name":"jser-info-mcp","url":"https://mcp.jser.info/mcp"}'
方法2: settings.jsonに追加

VSCodeのsettings.jsonに以下の設定を追加します：

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

これで自動的にJSer.info MCPが利用可能になります。

ローカルサーバーを利用する場合

  1. ターミナルで@jser/mcpを起動する

    npx @jser/mcp

  2. VSCodeのコマンドパレットを開き（Cmd+Shift+P または Ctrl+Shift+P）、「MCP: Add Server...」を実行

  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: URLからJSerアイテムを取得
利用できるtool

JSer.info MCPでは、次の tool が利用できます。

jser_search_items

タイトル、説明、URL、タグでアイテムを検索します。スペースで区切られた複数のキーワードをOR検索します。

パラメータ:

  • query: 検索クエリ（1-100文字）。スペースで区切られた複数のキーワードをOR検索
  • 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_product_name

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

指定したURLのアイテムを含むJSer週を取得します。

パラメータ:

  • 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: 関連リンクの配列

Source

データの取得は@jser/data-fetcherを利用する

  • データ取得の感覚は最後に実行してから1分経過したら再取得する
  • つまり1分間はキャッシュのデータを利用する

検索にはDataSetを利用する

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

プロダクト名の検索にはJSer.info Product Name APIを利用する

$ 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`.

Changelog

See Releases page.

Running tests

Install devDependencies and Run pnpm test:

pnpm test

コントリビューション

プルリクエストやスターをいつでも歓迎します。

バグや機能のリクエストについては、issue を作成してください。

  1. フォークします！
  2. フィーチャーブランチを作成します：git checkout -b my-new-feature
  3. 変更をコミットします：git commit -am 'Add some feature'
  4. ブランチにプッシュします：git push origin my-new-feature
  5. プルリクエストを送信します :D

作者

ライセンス

MIT © azu

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。