JA

jina-ai/mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

896 stars 95 forks 품질 89 트렌드 37Apache-2.0

공식 지나 AI 원격 MCP 서버

개요

Jina 리더, 임베딩, 리랭커 API에 대한 접근을 제공하는 원격 모델 컨텍스트 프로토콜(MCP) 서버로, URL-투-마크다운, 웹 검색, 이미지 검색, 임베딩/리랭커 도구 모음을 포함합니다: 선택 도구는 API 키 없이도 작동하지만 속도 제한이 있습니다. 더 높은 속도 제한과 더 나은 성능을 원한다면 Jina API 키를 사용하세요. https://jina.ai에서 무료 Jina API 키를 받을 수 있습니다. 일부 클라이언트는 env 변수를 지원하지 않아서, 아래 ${JINA_API_KEY}를 하드코딩된 실제 API 키 jina_xxx으로 교체해야 할 수도 있습니다. 서버는 Streamable HTTP 전송(MCP 사양 2025-03-26)을 사용합니다. /sse 엔드포인트는 하위 호환성을 위해 별칭으로 유지됩니다. 자세한 내용은 FAQ를 참조하세요. 원격 MCP 서버를 지원하는 클라이언트의 경우: 아직 원격 MCP 서버를 지원하지 않는 클라이언트의 경우, 원격 MCP 서버에 연결하려면 로컬 프록시인 mcp-remote가 필요합니다. 이전에 --transport sse를 추가했다면, 먼저 claude mcp remove -s user jina로 제거한 후 아래 명령어로 다시 추가하세요.

개요(AI 번역)

Jina 리더, 검색, 임베딩 및 리랭커 API를 위한 원격 모델 컨텍스트 프로토콜(MCP) 서버:

사용

[! 경고] 일부 클라이언트는 env 변수를 지원하지 않으므로, 아래의 ${JINA_API_KEY}를 하드코딩된 실제 API 키 [jina_xxx로 대체해야 할 수도 있습니다.

원격 MCP 서버를 지원하는 클라이언트의 경우:

클로드 코드에 대해:

OpenAI 코덱스의 경우: [~/.codex/config.toml를 찾아 다음 항목을 추가하세요:

아직 원격 MCP 서버를 지원하지 않는 클라이언트의 경우, 원격 MCP 서버에 연결하려면 mcp-remote의 로컬 프록시가 필요합니다.

사용 가능한 도구

도구 설명 Jina API 키가 필요한가요?
primer 국지적이고 시간 인식 가능한 응답을 위한 최신 맥락 정보 제공 아니오
read_url 마크다운으로 웹페이지나 PDF를 읽으세요. 전체 본문 대신 Reader API를 통해 question를 패스하세요 선택 사항*
capture_screenshot_url Reader API를 통해 웹페이지 스크린샷을 캡처하기 선택 사항*
guess_datetime_url 페이지의 게시 또는 마지막 업데이트 날짜를 신뢰도(confidence score)와 함께 추측해 아니요
search_web 웹 검색. Reader API를 통해 제목, URL 및 엔진 스니펫을 반환합니다 네

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Jina AI Remote MCP Server

A remote Model Context Protocol (MCP) server for the Jina Reader, Search, Embeddings and Reranker APIs:

Usage

[!WARNING] Some clients do not support env variable, so you may need to replace ${JINA_API_KEY} below to a hardcoded real API key jina_xxx.

For client that supports remote MCP server:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/v1",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}" // optional
      }
    }
  }
}

For Claude Code:

claude mcp add -s user --transport http jina https://mcp.jina.ai/v1 \
  --header "Authorization: Bearer ${JINA_API_KEY}"

For OpenAI Codex: find ~/.codex/config.toml and add the following:

[mcp_servers.jina-mcp-server]
command = "npx"
args = [
    "-y",
    "mcp-remote",
    "https://mcp.jina.ai/v1",
    "--header",
    "Authorization: Bearer ${JINA_API_KEY}"]

For client that does not support remote MCP server yet, you need mcp-remote a local proxy to connect to the remote MCP server.

{
  "mcpServers": {
    "jina-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.jina.ai/v1",
        "--header",
        "Authorization: Bearer ${JINA_API_KEY}"
      ]
    }
  }
}

Available tools

Tool Description Is Jina API Key Required?
primer Get current contextual information for localized, time-aware responses No
read_url Read a web page or PDF as markdown. Pass question for passages instead of the full body via Reader API Optional*
capture_screenshot_url Capture a screenshot of a web page via Reader API Optional*
guess_datetime_url Guess a page’s publish or last-update datetime, with a confidence score No
search_web Search the web. Returns titles, URLs and engine snippets via Reader API Yes
search_arxiv Search academic papers and preprints on arXiv repository via Reader API Yes
search_ssrn Search academic papers on SSRN (Social Science Research Network) via Reader API Yes
search_images Search the web for images via Reader API Yes
search_jina_blog Search Jina AI news and blog posts at jina.ai/news No
sort_by_relevance Rerank documents by relevance to a query via Reranker API Yes
deduplicate_strings Get top-k semantically unique strings via Embeddings API and submodular optimization Yes
GitHub에서 전체 README 보기

설치

npx mcp-remote https://mcp.jina.ai/v1 --header Authorization: Bearer ${JINA_API_KEY}
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "jina-mcp-server": { "url": "https://mcp.jina.ai/v1", "headers": { "Authorization": "Bearer ${JINA_API_KEY}" // optional } } } }