Kontext MCP Server

Kontext의 Context Packet을 Claude Desktop, Cursor, VS Code 등 AI 어시스턴트에서 조회할 수 있는 MCP(Model Context Protocol) 서버입니다.

설치 및 빌드

cd mcp-server
npm install
npm run build

API 키 발급

1. Kontext 로그인
2. Settings → API Keys 이동
3. "새 키 생성" 클릭
4. 생성된 키 (kx_...) 복사 후 안전하게 보관

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows) 파일에 다음 내용 추가:

{
  "mcpServers": {
    "Kontext": {
      "command": "node",
      "args": ["/절대경로/mcp-server/build/index.js"],
      "env": {
        "KONTEXT_URL": "https://kontext.so",
        "KONTEXT_API_KEY": "kx_your_key_here"
      }
    }
  }
}

중요: args의 경로는 절대 경로여야 합니다.

설정 후 Claude Desktop을 완전히 종료하고 다시 시작하세요.

환경변수

| 변수 | 설명 | 기본값 | |------|------|--------| | KONTEXT_API_KEY | API 키 (필수) | - | | KONTEXT_URL | Kontext 서버 URL | http://localhost:3000 |

제공 도구

1. get_context

Context Packet을 조회합니다.

파라미터:

• packet_id (optional): 특정 패킷 ID. 없으면 최신 패킷 반환
• format (optional): xml, markdown, json. 기본값: markdown

사용 예시:

"가장 최근 Context Packet을 보여줘"
"packet_abc123의 내용을 XML 형식으로 보여줘"

2. list_packets

사용 가능한 Context Packet 목록을 조회합니다.

파라미터:

• limit (optional): 최대 개수. 기본값: 10

사용 예시:

"내 Context Packet 목록 보여줘"
"최근 5개 패킷만 보여줘"

3. list_canvases

Kontext 캔버스 목록을 조회합니다.

파라미터: 없음

사용 예시:

"내 캔버스 목록 보여줘"

개발 모드

npm run dev  # TypeScript 감시 모드

문제 해결

API 키 오류

• Settings → API Keys에서 키가 활성화 상태인지 확인
• 키가 kx_로 시작하는지 확인

연결 안 됨

• Claude Desktop 완전히 종료 후 재시작
• 설정 파일의 JSON 문법 오류 확인 (마지막 항목 뒤 쉼표 제거)
• args의 경로가 절대 경로인지 확인

라이선스

MIT