Fork me on GitHub

JSer.info의 MCP 서버를 공개했습니다

Translator: rewrite0w0 Edit on GitHub See Revisions

AI Agent 같은 곳에서, JSer.info 데이터에 접근하기 위한 Model Context Protocol (MCP) 서버를 공개했습니다.

jser/mcp이란

jser/mcp이란, JSer.info 데이터셋에 프로그램으로 접근하기 위한 MCP 서버입니다.
MCP는, AI 에이전스나 개발도구가 외부 데이터 소스나 기능과 연계하기 위한 프로토콜입니다.
jser/mcp 이용함으로, JSer.info 가 소개한 아이템이나 작성한 글, URL 프로덕트명 (JSer.info 소개에서 이용하고 있음)을 얻을 수 있습니다.

jser/mcp 제공하는 tools

jser/mcp에 접속하면, 이하의 도구를 이용할 수 있습니다.

  • jser_search_items: JSer.info에 등록된 아이템 (글, 슬라이드, 라이브러리)를, 타이틀, 설명문, URL, 태그 같은 정보 기반으로 검색합니다. 복수의 키워드 지정한 경우에는 OR 검색입니다.
  • jser_search_posts: JSer.info의 주간 정리 글을, 타이틀, 설명문, URL, 태그 같은 정보 검색합니다.
  • jser_product_name: 지정된 URL에서 프로덕트명(예시: Deno, React) 를 지정해서 얻습니다. 연관 정보로, 그 URL이 리소스 노트인 확률이나 버전 정보를 포함할 수도 있습니다.
  • jser_week: JSer.info 주간 정리 글을, 몇 호인지 지정해 얻습니다.
  • jser_weeks: 지금까지 공개된 모든 JSer.info 주간 정리 글을 얻습니다.
  • jser_weeks_between: 지정한 날짜 범위 내의 공개된 JSer.info 주간 정리 기사를 얻습니다.
  • jser_week_with_item_url: 지정 아이템 URL이 포함된 JSer.info 주간 정리 글 정보를 얻습니다.
  • jser_item_with_item_url: 지정한 URL에 맞는 아이템의 상세 정보를 얻습니다.

이 도구를 이용해서, 「특정 JavaScript 라이브러리에 대한 것을 다루는 JSer.info 글 목록 얻기」같은 것이나, 「JSer.info 스타일에서 URL 글 해설」같은 것도 가능합니다.

예를 들어, jser-info-article.prompt.md 같은 프롬프트를 사용해, 다음과 같은 URL 전달하면, JSer.info 스타일로 글을 해설합니다.

Redux Toolkit v2.8.0 출시.
React Native 패키지 엑스포트를 수정 / Infinite Query 기본 파라메타 함수에 `queryArg` 추가.

같은 해설문을 생성할 수 있습니다.

jser/mcp 이용 방법

jser/mcp은, VSCode 같은 MCP 클라이언트에서 이용 가능합니다.
주된 이용방법으로, 공개된 원격 서버에 접속하는 방법과, 로컬 환경에서 서버를 동작하는 방법이 있습니다.

원격 서버 이용

공개된 원격 서버의 엔드포인트는 https://mcp.jser.info/mcp 입니다.

VSCode에서 설정 예시 1: 커맨드 라인에서 추가

VSCode가 설치된 환경에서는, 터미널에서 이하의 커맨드를 실행함으로 MCP 서버 정보를 추가할 수 있습니다.

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

VSCode에서 설정 예시 2: settings.json 에 추가

VSCode의 settings.json 파일에 이하 같은 설정을 작성함으로 이용 가능합니다.

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

로컬 서버 이용

로컬 환경에서 서버를 동작해서 이용하는 것도 가능합니다.

  1. 터미널에서 @jser/mcp 패키지를 실행해 서버를 동작합니다.
npx @jser/mcp
  1. VSCode의 명령어 팔렛트 (Cmd+Shift+P 혹은 Ctrl+Shift+P) 에서「MCP: Add Server...」선택합니다.
  2. 서버 URL로, 로컬 서버가 listen하고 있는 http://localhost:14561/mcp 입력해 접속합니다.

데이터 소스

JSer.info 데이터는 jser/dataset: JSer.info 데이터셋이나 처리 라이브러리에서 다룹니다.
기본적으로 지금까지 소개된 글이나 업로드한 글이 JSON으로 얻을 수 있습니다.

URL에서 프로덕트명(라이브러리명)를 과거 JSer.info 데이터 기반으로 합니다.
이 기능은 하나의 Web API로 공개합니다.

연관 정보

jser/mcp에서 관련해 상세 정보나 최신 정보에 대해서는, 이하의 레포지토리를 참조해주세요.

Pull Request to this article
JSer.info Slackに参加する