구성
HYPERSPELL_TOKEN유효한 사용자 또는 앱 토큰이어야 합니다(사용자 토큰을 얻는 방법은 Hyperspell 문서를 참조하세요).일부 MCP 클라이언트는 리소스를 제대로 지원하지 않으므로(Claude Desktop님, 말씀하신 대로입니다), 대신 도구로 노출할 수 있습니다.
HYPERSPELL_USE_RESOURCES``false(기본값)로 설정하면 모든 리소스를 도구로 노출하고,true설정하면 단일 문서 검색이나 컬렉션 목록만 리소스로 노출하며, 둘 다 원하는 경우both설정합니다.선택적으로,
HYPERSPELL_COLLECTION쿼리하고 데이터를 추가할 컬렉션의 이름으로 설정할 수 있습니다. 설정하지 않으면 사용자의 기본 컬렉션이 대신 사용됩니다.
Related MCP server: Hyperbrowser
클로드 데스크탑
Claude에게는 uv 의 절대 경로가 필요한데, 이는 which uv 사용하여 찾을 수 있습니다(일반적으로 ~/.local/bin/uv 입니다).
지엑스피1
검사기 사용
다음 내용으로 .env 파일을 만듭니다.
HYPERSPELL_TOKEN=...
HYPERSPELL_USE_RESOURCES=true
그런 다음 다음을 실행하여 검사기를 시작합니다.
uv run mcp dev src/hyperspell_mcp/server.py