
jina-ai/mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
공식 지나 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 keyjina_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 |
설치
npx mcp-remote https://mcp.jina.ai/v1 --header Authorization: Bearer ${JINA_API_KEY}설정
{
"mcpServers": {
"jina-mcp-server": {
"url": "https://mcp.jina.ai/v1",
"headers": {
"Authorization": "Bearer ${JINA_API_KEY}" // optional
}
}
}
}