@jser/mcp

JSer.info 的 MCP 服务器

• 介绍 - 模型上下文协议

• modelcontextprotocol/typescript-sdk：用于模型上下文协议服务器和客户端的官方 Typescript SDK

用法

如何与 VSCode 一起使用

在 VSCode 中，您可以通过以下两种方式之一使用 JSer.info MCP：

如果您使用远程服务器（推荐）

您可以通过以下方式之一添加远程服务器：

方法一：从命令行添加

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

方法二：添加到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：添加服务器...”

3. 输入http://localhost:14561/mcp作为要连接的服务器URL。

可用功能

一旦连接，以下工具将可用：

• jser_search_items ：按标题、描述、URL 和标签搜索项目（多个关键字可以进行“或”运算）

• 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 项目

可用工具

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_product_name

从 URL 获取产品名称。

参数：

• url ：产品网址（必填）

返回：

• 产品信息对象

  • name ：产品名称

  • url ：产品网址

  • releaseNoteProbability ：发布说明的概率

  • releaseNoteVersion ：发行说明版本信息（如果适用）

  • releaseNoteURL ：发行说明的 URL（如果适用）

jser_week

从数字中获取 JSer 周数。

参数：

• number ：JSer 周数（必填）

返回：

• JSer Week 对象

  • number ：JSer 周数

  • startDate ：开始日期

  • endDate ：结束日期

  • items ：该周的物品清单

  • posts ：本周帖子列表

jser_weeks

获得所有 JSer 周数。

返回：

• JSer 周对象数组

  • number ：JSer 周数

  • startDate ：开始日期

  • endDate ：结束日期

  • items ：该周的物品清单

  • posts ：本周帖子列表

jser_周数

获取指定期间的 JSer 周数。

参数：

• beginDate ：期间的开始日期（必需）

• endDate ：期间的结束日期（必需）

返回：

• JSer 周对象数组

  • number ：JSer 周数

  • startDate ：开始日期

  • endDate ：结束日期

  • items ：该周的物品清单

  • posts ：本周帖子列表

  • itemsCount ：项目数量

  • postsCount ：帖子数量

jser_week_with_item_url

获取包含指定 URL 的项目的 JSer 周。

参数：

• item_url ：商品网址（必填）

返回：

• JSer Week 对象

  • number ：JSer 周数

  • startDate ：开始日期

  • endDate ：结束日期

  • items ：该周的物品清单

  • posts ：本周帖子列表

jser_item_with_item_url

获取指定 URL 处的项目。

参数：

• url ：商品的 URL（必填）

返回：

• Item 对象

  • title ：标题

  • url ：URL

  • description ：描述

  • tags ：标签数组

  • date ：日期

  • relatedLinks ：相关链接数组

Related MCP server: Documentation Search MCP Server

来源

使用@jser/data-fetcher获取数据

• 数据采集的间隔是上次执行后一分钟重新采集数据。

• 也就是说，缓存的数据使用一分钟。

使用数据集进行搜索

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 产品名称 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`.

变更日志

请参阅发布页面。

运行测试

安装 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

作者

• 来源： GitHub 、 Twitter

执照

麻省理工学院 © azu