@jser/mcp

An MCP Server for JSer.info

• Introduction - Model Context Protocol
• modelcontextprotocol/typescript-sdk: The official Typescript SDK for Model Context Protocol servers and clients

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週の番号