@jser/mcp

基本能力

产品定位

mcp-server 是一个为 JSer.info 提供服务的 MCP（Model Context Protocol）服务器，主要用于处理和查询 JSer.info 的数据。

核心功能

• 搜索功能：支持通过标题、描述、URL、标签等搜索 JSer.info 中的项目和帖子。
• 数据获取：可以获取 JSer 周信息、产品名称、特定 URL 的项目信息等。
• 本地和远程服务器支持：支持通过本地或远程服务器连接使用。

适用场景

• 开发者在 VSCode 中快速查询 JSer.info 的项目和帖子信息。
• 需要获取特定 URL 的产品名称或 JSer 周信息的场景。
• 需要批量查询 JSer.info 数据的开发和研究场景。

工具列表

1. jser_search_items：通过标题、描述、URL、标签搜索项目，支持多关键词 OR 搜索。
2. jser_search_posts：通过标题、描述、URL、标签搜索帖子。
3. jser_product_name：从 URL 获取产品名称及相关信息。
4. jser_week：通过编号获取 JSer 周信息。
5. jser_weeks：获取所有 JSer 周信息。
6. jser_weeks_between：获取指定日期范围内的 JSer 周信息。
7. jser_week_with_item_url：获取包含指定 URL 项目的 JSer 周信息。
8. jser_item_with_item_url：通过 URL 获取项目详细信息。

常见问题解答

• 数据更新频率：数据获取后 1 分钟内使用缓存，之后重新获取。
• 数据来源：使用 @jser/data-fetcher 和 JSer.info 的公开 API。

使用教程

使用依赖

无特殊依赖，直接通过 npm 或 npx 安装即可。

安装教程

远程服务器使用（推荐）

1. 通过命令行添加服务器：

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

1. 或在 VSCode 的 settings.json 中添加：

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

本地服务器使用

1. 启动本地服务器：

npx @jser/mcp

1. 在 VSCode 中通过命令面板添加服务器 URL http://localhost:14561/mcp。

调试方式

1. 运行测试：

pnpm test

1. 查看日志或通过 VSCode 的调试工具进行调试。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。