Linkup MCP 서버

Linkup의 고급 API를 통해 웹 검색 및 페이지 가져오기 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude와 같은 AI 어시스턴트는 자연어 쿼리로 지능적인 웹 검색을 수행하고 모든 웹페이지에서 콘텐츠를 가져와 웹상의 신뢰할 수 있는 출처로부터 실시간 정보에 액세스할 수 있습니다.

주요 기능

• 🔍 실시간 웹 검색: 최신 정보, 뉴스 및 데이터를 웹에서 검색

• 🌐 페이지 가져오기: 모든 웹페이지에서 콘텐츠를 가져오고 추출

• 🎯 자연어 쿼리: 전체 질문을 사용하여 최상의 결과 도출

• 📊 유연한 검색 깊이:

  • standard - 직접적인 답변이 필요한 쿼리용

  • deep - 여러 출처에 걸친 분석이 필요한 복잡한 조사용

• 🖥️ JavaScript 렌더링: 동적 콘텐츠를 위한 선택적 JS 렌더링

• ⚡ 빠른 속도: Linkup의 최적화된 인프라 기반

Related MCP server: ORZ MCP

설치

• Cursor, VSCode, Claude Code, Codex 또는 기타 MCP 호환 클라이언트

• Linkup API 키

API 키 발급받기

1. app.linkup.so에서 무료 Linkup 계정을 생성하세요.

2. 대시보드에서 API 키를 복사하세요.

원격 MCP 서버 (권장)

호스팅된 Linkup MCP 서버는 Streamable HTTP 전송을 사용합니다. 클라이언트가 원격 HTTP MCP 서버를 지원하는 경우, 호스팅된 엔드포인트를 직접 참조할 수 있습니다.

클라이언트가 사용자 지정 HTTP 헤더를 지원하는 경우, URL에 넣는 대신 Authorization: Bearer LINKUP_API_KEY로 API 키를 보내는 것을 권장합니다. ?apiKey=... 쿼리 매개변수는 사용자 지정 헤더를 보낼 수 없는 클라이언트를 위해 계속 지원됩니다.

Cursor

~/.cursor/mcp.json 파일에 다음을 추가하세요:

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "type": "http",
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
    }
  }
}

VSCode

VS Code MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 VS Code MCP 문서를 참조하세요.

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY",
      "type": "http"
    }
  }
}

Codex

Codex는 config.toml을 통해 원격 HTTP MCP 서버와 사용자 지정 HTTP 헤더를 모두 지원합니다.

환경 변수에서 베어러 토큰을 사용하는 경우:

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp"
bearer_token_env_var = "LINKUP_API_KEY"
enabled = true

또는 쿼리 매개변수를 계속 사용하려면:

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
enabled = true

MCP 번들 (Claude Desktop 권장)

Claude Desktop과 같은 호환 가능한 MCP 클라이언트에서 작동하는 독립형 패키지인 사전 빌드된 MCP 번들을 다운로드하세요. MCP 번들은 Anthropic에서 개발했습니다. 자세한 내용은 MCP 번들 저장소를 참조하세요.

빠른 다운로드:

curl -L -o linkup-mcp-server.mcpb https://github.com/LinkupPlatform/linkup-mcp-server/releases/latest/download/linkup-mcp-server.mcpb

설치:

1. 릴리스에서 linkup-mcp-server.mcpb를 다운로드합니다 (또는 위의 curl 명령 사용).

2. 파일을 클릭하여 설치합니다.

3. 메시지가 표시되면 API 키를 구성합니다.

로컬 MCP 서버

stdio 전송을 통해 로컬에서 MCP 서버를 실행할 수도 있습니다.

Cursor

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

VSCode

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

Codex

[mcp_servers.linkup]
command = "npx"
args = ["-y", "linkup-mcp-server", "apiKey=LINKUP_API_KEY"]
enabled = true

사용법

구성 후 AI 에이전트에게 웹 검색이나 웹페이지 콘텐츠 가져오기를 요청할 수 있습니다:

검색 예시:

• "AI 개발에 관한 최신 뉴스를 웹에서 검색해 줘"

• "도쿄의 현재 날씨는 어때?"

• "새로운 EU AI 법안에 대한 정보와 그것이 스타트업에 미치는 영향을 찾아줘"

• "NVIDIA의 최신 주가를 검색해 줘"

가져오기 예시:

• "https://example.com/article 의 콘텐츠를 가져와 줘"

• "이 블로그 게시물(https://blog.example.com/post)의 콘텐츠를 가져와서 요약해 줘"

• "JavaScript 렌더링을 활성화하여 https://example.com 을 가져와 줘"

검색 깊이

• 표준 검색(Standard Search): 직접적인 답변이 필요한 쿼리에 적합 (날씨, 주가, 간단한 사실)

• 심층 검색(Deep Search): 여러 출처에 걸친 분석이 필요한 복잡한 조사에 적합 (포괄적인 가이드, 비교 분석, 심층 연구)

사용 가능한 도구

linkup-search

Linkup을 사용하여 실시간으로 웹을 검색하고 신뢰할 수 있는 출처에서 최신 정보, 사실 및 뉴스를 검색합니다.

매개변수:

• query (필수): 자연어 검색 쿼리. 전체 질문이 가장 효과적입니다.

• depth (선택): 검색 깊이 - "standard"(기본값) 또는 "deep"

사용 사례:

• 실시간 데이터 (날씨, 주가, 스포츠 점수, 이벤트)

• 속보 및 시사 이슈

• 최근 연구 및 간행물

• 제품 정보 및 최신 가격

• 일정 및 가용성

• AI의 지식 베이스에 없는 모든 정보

linkup-fetch

모든 웹페이지 URL에서 콘텐츠를 가져오고 추출합니다.

매개변수:

• url (필수): 콘텐츠를 가져올 URL.

• renderJs (선택): JavaScript 콘텐츠를 렌더링할지 여부 (기본값: false). JavaScript를 통해 콘텐츠를 로드하는 동적 페이지의 경우 활성화하세요. 참고: 이 옵션은 요청 속도를 느리게 합니다.

사용 사례:

• 분석 또는 요약을 위한 페이지 콘텐츠 검색

• 뉴스 사이트에서 기사 콘텐츠 추출

• 기술 웹사이트에서 문서 가져오기

• 블로그 게시물 및 작성된 콘텐츠 가져오기

개발

사전 요구 사항

• Node.js >= 22.0.0

• npm

설정

# Install dependencies
npm install

HTTP 서버 실행

npm run dev

이 명령은 http://localhost:2121/mcp에서 로컬 Streamable HTTP 서버를 시작합니다.

stdio 전송으로 실행

npm run build:stdio
npm run start:stdio -- apiKey=YOUR_API_KEY

로컬 개발의 경우 환경 변수를 통해 키를 전달할 수도 있습니다:

LINKUP_API_KEY=YOUR_API_KEY npm run start:stdio

MCP Inspector로 테스트

npm run build:stdio
npm run inspector -- apiKey=YOUR_API_KEY

브라우저에서 MCP Inspector가 열리며, 여기서 검색 도구를 대화형으로 테스트할 수 있습니다.

라이선스

MIT

링크

• Linkup 웹사이트

• Linkup 문서

• 모델 컨텍스트 프로토콜

지원

문제가 발생하면 이메일 support@linkup.so로 문의하거나 Discord 서버에 참여하세요.