kagi-server MCP 서버

Kagi API 통합을 위한 MCP 서버

Kagi Search API를 통합하는 TypeScript 기반 MCP 서버입니다. 다음을 제공하여 핵심 MCP 개념을 보여줍니다.

• Kagi의 API를 사용하여 웹 검색 및 기타 작업을 수행하기 위한 도구(현재 비공개 베타 버전)

특징

구현된 도구

• kagi_search - Kagi를 사용하여 웹 검색 수행

  • 쿼리 문자열과 선택적 제한을 매개변수로 사용합니다.

  • Kagi의 API에서 검색 결과를 반환합니다.

계획된 도구(아직 구현되지 않음)

• kagi_summarize - 웹 페이지 또는 텍스트 요약 생성

• kagi_fastgpt - Kagi의 FastGPT를 사용하여 빠른 응답 받기

• kagi_enrich - 특정 주제에 대한 풍부한 뉴스 결과 가져오기

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

환경 설정

Kagi API 키로 루트 디렉토리에 .env 파일을 만듭니다.

API 키를 안전하게 보호하려면 .gitignore 파일에 .env 추가해야 합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Kagi Server를 자동으로 설치하는 방법:

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

용법

서버가 실행되고 Claude Desktop에 연결되면 웹 검색을 수행할 수 있습니다. 예:

1. 클로드에게 물어보세요: "양자 컴퓨팅의 최신 발전에 대한 정보를 검색할 수 있나요?"

2. 클로드는 kagi_search 도구를 사용하여 Kagi의 API에서 결과를 가져옵니다.

3. 그러면 클로드가 검색 결과를 요약하거나 분석해 줄 것입니다.

참고: 계획된 도구(summarize, fastgpt, enrich)는 아직 구현되지 않았으므로 사용할 수 없습니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 기여 가능한 분야는 다음과 같습니다.

• 계획된 도구(요약, fastgpt, enrich) 구현

• 오류 처리 및 입력 검증 개선

• 문서화 및 사용 사례 개선

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

로드맵

• 웹 페이지 및 텍스트 요약을 위한 kagi_summarize 도구 구현

• 빠른 응답을 위한 kagi_fastgpt 도구 구현

• 풍부한 뉴스 결과를 가져오기 위한 kagi_enrich 도구 구현

• 오류 처리를 개선하고 더욱 강력한 입력 검증을 추가합니다.

• 더욱 포괄적인 사용 예와 문서를 추가하세요

• Claude Desktop 및 npx와 함께 쉽게 설치하고 사용할 수 있도록 패키지를 npm에 게시합니다.