Groundlink MCP Server

어떤 Model Context Protocol (MCP) 호스트에서든 Groundlink의 인용 정보가 포함된 웹 검색 결과를 사용하세요. 이 서버는 groundlink_add라는 하나의 집중된 도구를 제공하며, 이 도구는 Groundlink에 쿼리를 보내고 출처가 포함된 결과(title, url, snippet, source)를 반환합니다. 모델이 추측이 아니라 근거가 필요할 때 사용할 수 있습니다.

Groundlink는 현재 Wikipedia와 DuckDuckGo 결과를 결합합니다. 각 Groundlink API 키에는 100개의 무료 테스트 쿼리가 포함됩니다. 이후에는 선불 사용 요금이 쿼리당 $0.001 (쿼리당 1크레딧)입니다.

패키지: groundlink-mcp@0.1.1이 npm에 게시되어 있습니다. 소스: https://github.com/ohhavefun/groundlink

• 라이브 API 문서: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs

• 가격 및 크레딧: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing

도구

팩트 기반 질문에 사용하며, 호스트가 답변과 함께 URL/출처를 반환해야 하는 경우에 적합합니다. 이 MCP 서버는 의도적으로 가볍게 유지됩니다. 쿼리를 Groundlink HTTPS API에 전달하고 API 응답을 MCP stdio를 통해 반환합니다.

Related MCP server: DeepSearch MCP

설치 및 실행

Groundlink API 키(glk_...)가 필요합니다. Groundlink 운영자에게 요청하거나 Groundlink 온보딩 절차를 통해 키를 얻을 수 있습니다.

npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcp

또는 MCP 호스트가 전역 설치 없이 패키지를 직접 실행할 수 있습니다.

npx -y groundlink-mcp

이 프로세스는 stdio를 사용하며 HTTP 포트를 열지 않고 표준 출력에 일반적인 출력을 인쇄하지 않습니다. MCP 호스트는 대화형으로 실행하기보다는 프로세스를 시작하는 방식으로 사용해야 합니다.

구성

Claude Desktop 구성

Claude Desktop의 MCP 구성 파일에 다음 항목을 추가하고 Claude Desktop을 다시 시작하세요. API 키를 비공개로 유지하고, 저장소에 커밋하거나 구성 파일을 공유하지 마세요.

{
  "mcpServers": {
    "groundlink": {
      "command": "npx",
      "args": ["-y", "groundlink-mcp"],
      "env": {
        "GROUNDLINK_API_KEY": "glk_your_key_here"
      }
    }
  }
}

패키지가 전역으로 설치된 경우 "command": "groundlink-mcp"를 사용하고 args는 생략하세요. 절대 실행 파일 경로가 필요한 호스트에서는 command를 설치된 groundlink-mcp 바이너리를 가리키도록 설정하세요.

오류 처리 동작

• GROUNDLINK_API_KEY 누락: 서버가 시작 시 명확한 설정 오류와 함께 종료됩니다.

• API 키 거부됨(401): 도구 오류로 MCP 호스트에게 반환됩니다. 키를 수정해야 하며 재시도하지 마세요.

• 무료 또는 선불 크레딧이 남아 있지 않음(402): 도구 오류로 반환되며, 검색 전에 키를 충전해야 합니다.

• 검색 소스 중단(502): 도구 오류로 반환되며, 짧은 재시도가 도움이 될 수 있습니다.

마켓플레이스 설명

Groundlink — 인용 기반 웹 검색 for MCP. Claude, Cursor 및 기타 MCP 호스트에 근거 없는 팩트 추측 대신 출처가 포함된 결과를 반환하는 groundlink_search 도구를 하나 제공합니다. 모든 키는 100개의 무료 테스트로 시작하고, 이후에는 선결제 크레딧으로 쿼리당 $0.001의 사용 요금이 적용됩니다.

개발 및 릴리스 점검

bun install
bun run typecheck
bun run build             # emits executable dist/index.js
bun run test              # MCP stdio smoke test
npm run pack:check        # inspect the npm tarball without publishing

npm 패키지에는 의도적으로 컴파일된 dist/ 런타임, 이 README 및 npm이 요구하는 패키지 메타데이터만 포함됩니다. 소스 코드와 스모크 테스트는 tarball에 포함되지 않습니다.