Kagi Session2API MCP 서버

무료 Kagi 검색 MCP(Model Context Protocol) 서버 — 공식 유료 API 없이 세션 토큰을 통해 Kagi 검색 및 요약 기능을 사용하세요. Claude Desktop, Cursor, Windsurf, Cline, Hermes 및 모든 MCP 호환 AI 코딩 어시스턴트/에이전트와 함께 작동합니다.

English | 中文文档

⚠️ 사용자 주의사항: 이 프로젝트는 공식 유료 API 없이 Kagi 세션 토큰을 사용하여 검색 및 요약 기능에 액세스합니다. 이는 Kagi 서비스 약관을 위반할 수 있습니다. 계정 정지 또는 영구 차단과 같은 결과가 발생할 수 있습니다. 사용 시 위험은 본인이 감수해야 합니다. 작성자는 Kagi에 의해 취해진 어떠한 계정 조치에 대해서도 책임을 지지 않습니다.

⚠️ 보안 주의사항: Kagi 세션 토큰은 전체 계정 액세스 권한을 제공합니다. 비밀번호처럼 취급하십시오. 절대 공유하거나 버전 관리 시스템에 커밋하지 마십시오.

기능

• 세션 기반 액세스: 공식 API($25/1000 쿼리) 대신 Kagi 세션 토큰을 사용하여 완전히 무료로 이용 가능

• 멀티 토큰 풀: 라운드 로빈 방식으로 여러 토큰을 구성하여 더 높은 처리량 확보

• 토큰별 속도 제한: 토큰 버킷 알고리즘을 사용하여 토큰당 초당 5회 요청 제한

• API 호환 출력: 공식 kagimcp와 동일한 형식으로 결과 반환

• 두 가지 도구: kagi_search_fetch(웹 검색) 및 kagi_summarizer(URL 요약)

• Firefox UA 스푸핑: 세션 기반 액세스를 위해 실제 Firefox 브라우저를 모방

• 만료된 토큰 자동 비활성화: 만료된 토큰을 자동으로 감지하고 건너뜀

• 검색 연산자: Kagi 연산자(site:, lang:, filetype: 등) 지원

호환 플랫폼

MCP 호환 클라이언트라면 무엇이든 작동합니다:

• Claude Desktop

• Cursor

• Windsurf

• Cline

• Hermes Agent

• stdio 또는 HTTP 전송을 지원하는 모든 MCP 클라이언트

빠른 설치 (AI 에이전트용)

AI 에이전트에 다음 프롬프트를 붙여넣기만 하면 됩니다:

Install the Kagi Session2API MCP server from https://pypi.org/project/kagi-session2api-mcp/.
Then add it to my MCP:
`uvx kagi-session2api-mcp`
set env KAGI_SESSION_TOKEN to my token (ask me if you don't have it).
If I have multiple tokens, use KAGI_SESSION_TOKENS (comma-separated) instead,
or create a config file at ~/.config/kagi-session2api-mcp/config.toml with:
[kagi]
session_tokens = ["TOKEN_1", "TOKEN_2"]
summarizer_engine = "cecil"
[client]
timeout = 30
max_retries = 2
and set env KAGI_SESSION_CONFIG to that path.

수동 설치

pip install kagi-session2api-mcp

또는 uvx 사용:

uvx kagi-session2api-mcp

구성

옵션 1: 환경 변수 (단일 토큰)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKEN": "YOUR_SESSION_TOKEN_HERE"
      }
    }
  }
}

옵션 2: 환경 변수 (다중 토큰)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKENS": "TOKEN_1,TOKEN_2,TOKEN_3"
      }
    }
  }
}

옵션 3: 구성 파일 (다중 토큰 권장)

~/.config/kagi-session2api-mcp/config.toml 파일을 생성합니다:

[kagi]
session_tokens = [
    "YOUR_TOKEN_1_HERE",
    "YOUR_TOKEN_2_HERE",
]

summarizer_engine = "cecil"

[client]
timeout = 30
max_retries = 2

그런 다음 구성합니다:

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_CONFIG": "/path/to/config.toml"
      }
    }
  }
}

세션 토큰 가져오기

1. kagi.com에 로그인합니다.

2. **설정(Settings) → 계정(Account) → 세션 링크(Session Link)**로 이동합니다.

3. 세션 URL에서 토큰을 복사합니다: https://kagi.com/search?token={이 부분}&q=test

4. 이 토큰을 구성에 사용합니다.

사용법

MCP 도구

kagi_search_fetch

Kagi를 사용하여 웹 검색:

Search for "Python async tutorial"

Kagi 검색 연산자 지원:

• site:github.com - 도메인 제한

• -site:reddit.com - 도메인 제외

• filetype:pdf - 파일 형식 필터

• intitle:python - 제목 필터

• lang:zh - 언어 필터

• before:2024-01-01 / after:2024-01-01 - 날짜 필터

• "exact phrase" - 정확히 일치하는 구문

kagi_summarizer

URL 요약:

Summarize https://example.com/article

옵션:

• summary_type: "summary"(산문) 또는 "takeaway"(글머리 기호)

• engine: "cecil"(기본값), "agnes", "daphne", "muriel"

• target_language: 언어 코드 (예: "EN")

⚠️ 요약기는 실험적 기능이며, 변경될 수 있는 Kagi의 내부 엔드포인트를 사용합니다.

전송 모드

Stdio (기본값, Claude Desktop용):

kagi-session2api-mcp

HTTP (원격 액세스용):

kagi-session2api-mcp --http --host 0.0.0.0 --port 8000

아키텍처

MCP Client → FastMCP Server → TokenPool (round-robin) → httpx.AsyncClient → kagi.com
                                ↓
                          TokenBucket (5 req/s per token)
                                ↓
                          Auto-disable expired tokens

토큰 풀 동작

토큰이 만료되면(401/403 또는 로그인 페이지로 리디렉션되어 감지됨) 자동으로 비활성화됩니다. 나머지 토큰은 계속해서 요청을 처리합니다.

공식 kagimcp와의 차이점

위험 요소

• Kagi가 HTML 구조를 변경하면 파서가 작동하지 않을 수 있습니다.

• 세션 기반 액세스는 Kagi 서비스 약관을 위반할 수 있습니다.

• 계정 정지 또는 영구 차단이 발생할 수 있습니다.

• 요약기 엔드포인트는 내부용이며 예고 없이 변경될 수 있습니다.

• 사용 시 위험은 본인이 감수해야 합니다. 작성자는 Kagi에 의해 취해진 계정 조치를 포함한 어떠한 결과에 대해서도 책임을 지지 않습니다.

라이선스

MIT