@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

Usage in VSCode

In VSCode, you can use JSer.info MCP in one of the following ways:

Using a Remote Server (Recommended)

You can add a remote server using either of the following methods:

Method 1: Add via Command Line

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

Method 2: Add to settings.json

Add the following configuration to your VSCode settings.json: json "mcp": { "servers": { "jser-info-mcp": { "url": "https://mcp.jser.info/mcp" } } }

This will automatically make JSer.info MCP available.

Using a Local Server

1. Start @jser/mcp in the terminal bash npx @jser/mcp

2. Open the VSCode command palette (Cmd+Shift+P or Ctrl+Shift+P) and run MCP: Add Server...

3. Enter http://localhost:14561/mcp as the server URL to connect

Available Features

After connecting, the following tools will be available:

• jser_search_items: Search items by title, description, URL, and tags (supports OR search with multiple keywords)
• jser_search_posts: Search posts by title, description, URL, and tags
• jser_product_name: Get product name from URL
• jser_week: Get JSer week by number
• jser_weeks: Get all JSer weeks
• jser_weeks_between: Get JSer weeks between two dates
• jser_week_with_item_url: Get JSer week containing an item
• jser_item_with_item_url: Get JSer item by URL

Available Tools

JSer.info MCP provides the following tools.

jser_search_items

Searches items by title, description, URL, and tags. Multiple keywords separated by spaces are searched with OR logic.

Parameters:

• query: Search query (1-100 characters). Multiple keywords separated by spaces are searched with OR logic.
• limit: Maximum number of results to return (1-100, default: 10)
• offset: Offset of the results (0 or greater, default: 0)
• order: Sort order
  • desc: Newest first (default)
  • asc: Oldest first

Return Value:

• Array of items
  • title: Title of the item
  • url: URL of the item
  • content: Description of the item
  • tags: Array of tags
  • date: Registration date and time
  • relatedLinks: Array of related links

jser_search_posts

Searches posts by title, description, URL, and tags.

Parameters:

• query: Search query (1-100 characters)
• limit: Maximum number of results to return (1-100, default: 10)
• offset: Offset of the results (0 or greater, default: 0)
• sort: Sort criteria
  • relevance: By relevance (default)
  • date: By date
• order: Sort order
  • desc: Newest first / highest relevance (default)
  • asc: Oldest first / lowest relevance

Return Value:

• Array of posts
  • title: Title of the post
  • url: URL of the post
  • content: Content of the post
  • tags: Array of tags
  • date: Posting date and time

jser_product_name

Gets the product name from a URL.

Parameters:

• url: URL of the product (required)

Return Value:

• Product information object
  • name: Product name
  • url: URL of the product
  • releaseNoteProbability: Probability that it is a release note
  • releaseNoteVersion: Version information of the release note (if applicable)- releaseNoteURL: URL of the release note (if applicable)

jser_week

Retrieves a JSer week by its number.

Parameters:

• number: The number of the JSer week (required)

Return Value:

• A JSer week object
  • number: The number of the JSer week
  • startDate: Start date
  • endDate: End date
  • items: List of items for that week
  • posts: List of posts for that week

jser_weeks

Retrieves all JSer weeks.

Return Value:

• An array of JSer week objects
  • number: The number of the JSer week
  • startDate: Start date
  • endDate: End date
  • items: List of items for that week
  • posts: List of posts for that week

jser_weeks_between

Retrieves JSer weeks within a specified period.

Parameters:

• beginDate: Start date of the period (required)
• endDate: End date of the period (required)

Return Value:

• An array of JSer week objects
  • number: The number of the JSer week
  • startDate: Start date
  • endDate: End date
  • items: List of items for that week
  • posts: List of posts for that week
  • itemsCount: Number of items
  • postsCount: Number of posts

jser_week_with_item_url

Retrieves a JSer week containing an item with the specified URL.

Parameters:

• item_url: URL of the item (required)

Return Value:

• A JSer week object
  • number: The number of the JSer week
  • startDate: Start date
  • endDate: End date
  • items: List of items for that week
  • posts: List of posts for that week

jser_item_with_item_url

Retrieves an item with the specified URL.

Parameters:

• url: URL of the item (required)

Return Value:

• An item object
  • title: Title
  • url: URL
  • description: Description
  • tags: Array of tags
  • date: Date
  • relatedLinks: Array of related links

Source

Data retrieval is done using @jser/data-fetcher.

• Data is fetched again if one minute has passed since the last fetch.
• In other words, cached data is used for up to one minute.

For searching, DataSet is utilized.

Item: Refers to the site being introduced 1 Item = 1 Site This is the origin of all data. Each site includes a title, URL, registration date, and tags. API: https://jser.info/source-data/items.json Post: Refers to articles posted on JSer.info 1 Post = 1 Article Each article includes a title, URL, tags, and date. Using @jser/stat, you can search for articles that i…