@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에서는 다음 도구를 사용할 수 있습니다.

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 주 번호

  • startDate : 시작일

  • endDate : 종료일

  • items : 그 주의 아이템 목록

  • posts : 그 주의 포스트리스트

  • itemsCount : 아이템 수

  • postsCount : 게시

jser_week_with_item_url

지정된 URL의 항목을 포함하는 JSer 주를 가져옵니다.

매개변수:

• item_url : 항목 URL(필수)

반환값:

• JSer 주 객체

  • number : JSer 주 번호

  • startDate : 시작일

  • endDate : 종료일

  • items : 그 주의 아이템 목록

  • posts : 그 주의 포스트리스트

jser_item_with_item_url

지정된 URL의 항목을 가져옵니다.

매개변수:

• url : 아이템 URL(필수)

반환값:

• 아이템 객체

  • title : 제목

  • url : URL

  • description : 설명

  • tags : 태그 배열

  • date : 날짜

  • relatedLinks : 관련 링크의 배열

Related MCP server: Documentation Search MCP Server

소스

데이터의 취득은 @jser/data-fetcher 를 이용한다

• 데이터 취득의 감각은 마지막에 실행하고 나서 1분 경과하면 재 취득

• 즉 1분간은 캐시의 데이터를 이용한다

검색에는 DataSet 을 이용한다

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 Product Name 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`.

Changelog

See Releases page .

Running tests

Install devDependencies and Run pnpm test :

pnpm test

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue .

1. Fork it!

2. Create your feature branch: git checkout -b my-new-feature

3. Commit your changes: git commit -am 'Add some feature'

4. Push to the branch: git push origin my-new-feature

5. Submit a pull request :D

작성자

• azu: GitHub , Twitter

License

MIT © azu