JSON 데이터 쿼리 및 조작을 위한 JSON 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 LLM은 표준화된 도구 세트를 통해 JSON 데이터와 상호 작용할 수 있습니다.
설치 및 사용
지엑스피1
구성 요소
도구
- 질문
- 확장된 작업을 사용하여 JSONPath 구문을 사용하여 JSON 데이터 쿼리
- 입력:
url
(문자열): JSON 데이터 소스의 URLjsonPath
(문자열): 선택적 작업이 포함된 JSONPath 표현식
- 필터
- 조건을 사용하여 JSON 데이터 필터링
- 입력:
url
(문자열): JSON 데이터 소스의 URLjsonPath
(문자열): 기본 JSONPath 표현식condition
(문자열): 필터 조건
지원되는 작업
배열 연산
- 슬라이싱 :
$[0:5]
, $[-3:]
, $[1:4]
- 정렬 :
$.sort(price)
, $.sort(-price)
- Distinct :
$.distinct()
- 변형 :
- 맵:
$.map(fieldName)
- 평평하게 만들기:
$.flatten()
- 유니온:
$.union([1,2,3])
- 교차:
$.intersection([1,2,3])
문자열 연산
- 케이스 :
$.toLowerCase()
, $.toUpperCase()
- 테스트 :
$.startsWith('test')
, $.endsWith('test')
- 검색 :
$.contains('test')
, $.matches('pattern')
수치 연산
- 수학 :
$.math(+10)
, $.pow2()
- 반올림 :
$.round()
, $.floor()
, $.ceil()
- 함수 :
$.abs()
, $.sqrt()
날짜 작업
- 형식 :
$.format('YYYY-MM-DD')
- 확인 :
$.isToday()
- 수정 :
$.add(1, 'days')
집계 작업
- 그룹 :
$.groupBy(category)
- 통계 :
$.sum(price)
, $.avg(price)
, $.min(price)
, $.max(price)
구성
Claude Desktop과 함께 사용
Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json
에 다음 구성을 추가하세요.
{
"json": {
"command": "npx",
"args": [
"@gongrzhe/server-json-mcp@1.0.3"
]
}
}
또는 패키지가 설치되어 있다면 node 명령을 직접 사용할 수 있습니다.
{
"json": {
"command": "node",
"args": [
"path/to/build/index.js"
]
}
}
개발
소스에서 빌드
- 저장소를 복제합니다
- 종속성 설치:
- 프로젝트를 빌드하세요:
노트
- 모든 JSONPath 표현식은 루트 객체를 나타내는
$
로 시작합니다. - 배열 인덱스는 0부터 시작합니다.
- 연산의 문자열 값은 따옴표로 묶어야 합니다.
- 날짜 연산은 '일', '월', '년' 단위를 지원합니다.
- 숫자 연산은 기본 산술 연산자(+, -, *, /)를 지원합니다.
특허
MIT