카기 MCP 서버
설정 지침
검색 도구가 아닌 다른 도구를 사용하는 경우가 아니라면, 무엇보다 먼저 검색 API에 액세스할 수 있는지 확인하세요. 현재 비공개 베타 버전이며 요청 시 제공됩니다. 초대장을 받으시려면 support@kagi.com 으로 문의하세요.
먼저 uv를 설치하세요.
MacOS/리눅스:
지엑스피1
윈도우:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Smithery를 통해 설치
또는 Smithery를 통해 Claude Desktop용 Kagi를 설치할 수 있습니다.
npx -y @smithery/cli install kagimcp --client claude
Claude Desktop으로 설정
// claude_desktop_config.json
// Can find location through:
// Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"kagi": {
"command": "uvx",
"args": ["kagimcp"],
"env": {
"KAGI_API_KEY": "YOUR_API_KEY_HERE"
"KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // Defaults to "cecil" engine if env var not present
}
}
}
}
도구 사용이 필요한 포즈 쿼리
예를 들어 검색을 원하면 "타임지 선정 2024년 올해의 인물은 누구였을까?"를 입력하거나, 요약을 원하면 "이 영상을 요약해 주세요: https://www.youtube.com/watch?v=jNQXAC9IVRw "를 입력하세요.
디버깅
달리다:
npx @modelcontextprotocol/inspector uvx kagimcp
로컬/개발자 설정 지침
복제 저장소
git clone https://github.com/kagisearch/kagimcp.git
종속성 설치
먼저 uv를 설치하세요.
MacOS/리눅스:
curl -LsSf https://astral.sh/uv/install.sh | sh
윈도우:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
그런 다음 MCP 서버 종속성을 설치합니다.
cd kagimcp
# Create virtual environment and activate it
uv venv
source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows
# Install dependencies
uv sync
Claude Desktop으로 설정
MCP CLI SDK 사용
# `pip install mcp[cli]` if you haven't
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=API_KEY_HERE"
수동으로
# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"kagi": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp",
"run",
"kagimcp"
],
"env": {
"KAGI_API_KEY": "YOUR_API_KEY_HERE"
"KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // Defaults to "cecil" engine if env var not present
}
}
}
}
도구 사용이 필요한 포즈 쿼리
예를 들어 검색을 원하면 "타임지 선정 2024년 올해의 인물은 누구였을까?"를 입력하거나, 요약을 원하면 "이 영상을 요약해 주세요: https://www.youtube.com/watch?v=jNQXAC9IVRw "를 입력하세요.
디버깅
달리다:
# If mcp cli installed (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py
# If not
npx @modelcontextprotocol/inspector \
uv \
--directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp \
run \
kagimcp
그런 다음 http://localhost:5173 에서 MCP Inspector에 접속하세요. Inspector의 환경 변수 KAGI_API_KEY 에 Kagi API 키를 추가해야 할 수도 있습니다.
고급 구성
- 로깅 수준은
FASTMCP_LOG_LEVEL 환경 변수(예: FASTMCP_LOG_LEVEL="ERROR" )를 통해 조정 가능합니다. - 요약기 엔진은
KAGI_SUMMARIZER_ENGINE 환경 변수(예: KAGI_SUMMARIZER_ENGINE="daphne" )를 사용하여 사용자 정의할 수 있습니다.