Crossref MCP 서버
Crossref API와 상호작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.
특징
- 제목으로 작품 검색
- 작가별 작품 검색
- DOI로 작업 세부 정보 가져오기
설치
지엑스피1
용법
서버는 세 가지 주요 도구를 제공합니다.
1. 제목으로 검색
제목으로 Crossref에서 작품 검색:
// Example: Search for works containing "quantum computing" in the title
{
"title": "quantum computing",
"rows": 5 // Optional, defaults to 5
}
2. 작성자로 검색
저자별로 Crossref에서 작품 검색:
// Example: Search for works by "Einstein"
{
"author": "Einstein",
"rows": 5 // Optional, defaults to 5
}
3. DOI로 작업 가져오기
DOI를 사용하여 특정 작품을 검색합니다.
// Example: Get work with DOI "10.1088/1742-6596/1398/1/012023"
{
"doi": "10.1088/1742-6596/1398/1/012023"
}
응답 형식
모든 응답은 다음 형식의 구조화된 JSON 객체로 반환됩니다.
성공적인 검색을 위해:
{
"status": "success",
"query": {
/* the original query parameters */
},
"count": 5,
"results": [
{
"title": "Work title",
"authors": [
{
"given": "First name",
"family": "Last name",
"name": "First name Last name"
}
],
"published": {
"dateParts": [2023, 1, 15],
"dateString": "2023-1-15"
},
"type": "journal-article",
"doi": "10.xxxx/xxxxx",
"url": "https://doi.org/10.xxxx/xxxxx",
"container": "Journal Name",
"publisher": "Publisher Name",
"issue": "1",
"volume": "42",
"abstract": "This is the abstract of the work, if available."
}
// additional results...
]
}
단일 DOI 조회의 경우:
{
"status": "success",
"query": { "doi": "10.xxxx/xxxxx" },
"result": {
// work details as shown above
}
}
오류가 있거나 결과가 없는 경우:
{
"status": "error" | "no_results" | "not_found",
"message": "Error message" | null,
"query": { /* the original query parameters */ }
}
테스트
이 서버에는 Vitest를 활용한 포괄적인 테스트 도구가 포함되어 있습니다. 테스트는 사용 가능한 모든 도구를 다루며, 성공적인 응답, 빈 결과, 오류 처리 등 다양한 시나리오를 포함합니다.
테스트 실행
테스트 구조
이 테스트는 Vitest의 모의 기능을 사용하여 실제 네트워크 요청을 하지 않고 Crossref API 응답을 시뮬레이션합니다. 테스트 구조는 다음과 같습니다.
- 모의 데이터 : 제목 검색, 저자 검색 및 DOI 조회에 대한 샘플 응답
- 모의 핸들러 :
mcp-server-test-handlers.js 의 핸들러 함수 테스트 버전 - 테스트 사례 : 다음을 포함하는 모든 도구에 대한 테스트:
- 성공적인 API 응답
- 빈 결과 세트
- 오류 처리 및 네트워크 장애
테스트 확장
테스트 사례를 더 추가하려면:
- 필요한 경우 테스트 파일에 새로운 모의 데이터를 추가합니다.
- 관련 설명 블록에 추가 테스트 케이스를 만듭니다.
- API 응답을 시뮬레이션하려면
mockFetchResponse() 도우미를 사용하세요.
예:
it("should handle a new edge case", async () => {
// Mock the response
mockFetchResponse({
// Your sample response data
});
// Call the handler
const result = await handlers.searchByTitle({ title: "example" });
// Assert the expected results
expect(result).toMatchObject({
// Expected response structure
});
});