remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Integrates Kagi Search API capabilities, allowing web searches with customizable result limits to retrieve information from Kagi's search engine.
kagi-server 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에 연결되면 웹 검색을 수행할 수 있습니다. 예:
- 클로드에게 물어보세요: "양자 컴퓨팅의 최신 발전에 대한 정보를 검색할 수 있나요?"
- 클로드는
kagi_search도구를 사용하여 Kagi의 API에서 결과를 가져옵니다. - 그러면 클로드가 검색 결과를 요약하거나 분석해 줄 것입니다.
참고: 계획된 도구(summarize, fastgpt, enrich)는 아직 구현되지 않았으므로 사용할 수 없습니다.
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 기여 가능한 분야는 다음과 같습니다.
- 계획된 도구(요약, fastgpt, enrich) 구현
- 오류 처리 및 입력 검증 개선
- 문서화 및 사용 사례 개선
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.
로드맵
- 웹 페이지 및 텍스트 요약을 위한
kagi_summarize도구 구현 - 빠른 응답을 위한
kagi_fastgpt도구 구현 - 풍부한 뉴스 결과를 가져오기 위한
kagi_enrich도구 구현 - 오류 처리를 개선하고 더욱 강력한 입력 검증을 추가합니다.
- 더욱 포괄적인 사용 예와 문서를 추가하세요
- Claude Desktop 및 npx와 함께 쉽게 설치하고 사용할 수 있도록 패키지를 npm에 게시합니다.