remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Uses Bun for running the MCP server, utilized as the runtime environment for the application. The '--watch' flag suggests it provides hot reloading functionality during development.

Gemini Docs MCP 서버

설명

이 프로젝트는 200만 토큰의 거대한 컨텍스트 창을 제공하는 Gemini API를 사용하여 다양한 기술 문서에 접근할 수 있는 MCP 서버를 구현합니다. 모든 클라이언트에서 작동해야 하지만, 특히 Roo/Cline 환경을 대상으로 합니다.

이 접근 방식은 단순히 웹을 탐색하거나 검색 엔진을 사용하는 것보다 여러 가지 이점을 제공합니다.

큐레이팅된 지식 기반에 대한 접근: LLM은 특정 문서 세트를 사용하여 모델을 혼란스럽게 할 수 있는 쓰레기 결과와 거짓 양성 결과를 방지합니다.
컨텍스트 창 제한을 극복합니다. 문서를 직접 제공함으로써 LLM은 웹 검색만으로는 접근하기 어려운 더 많은 정보에 접근할 수 있습니다.
맞춤화되고 신중하게 고려된 답변: LLM은 단순히 문서의 일부만 제공하는 것이 아니라, 해당 기술의 전체 사양을 고려하여 논리적으로 구성된 답변을 제공합니다. 이를 통해 "X를 수행하는 다른 방법은 무엇인가?" 또는 "이 스니펫이 관용적인가?"와 같은 더욱 복잡한 질문도 가능합니다.

또한 기존 RAG 시스템의 몇 가지 문제점을 극복합니다.

청크 분할 필요 없음: LLM은 한 번에 전체 문서에 액세스할 수 있으므로 문서를 작은 조각으로 분할하거나 가능한 모든 방법을 고통스럽게 테스트하고 선택할 필요가 없습니다.
검색기가 필요 없습니다. Gemini API 자체가 전체 문서에 액세스할 수 있는 강력한 검색기 역할을 하므로 사용자 정의 검색기를 구현할 필요가 없습니다.
벡터화, 벡터 DB 또는 기타 복잡한 시스템 없이 일반 텍스트를 직접 처리하며, 모든 것을 한 번에 볼 수 있으므로 유사성 검색에 벡터가 필요하지 않습니다. 관련성이 있으면 바로 알 수 있습니다.

하지만 몇 가지 제한 사항이 있습니다.

실시간 업데이트 없음: 문서는 정적이며 실시간으로 업데이트되지 않습니다. 즉, LLM은 문서를 수동으로 업데이트하거나 자동화된 방법을 제공하지 않는 한 최신 기능이나 기술 변경 사항을 알지 못할 수 있습니다.
토큰이 많다고 해서 무한한 컨텍스트 윈도우가 있는 것은 아닙니다. LLM은 한 번에 약 200만 개의 토큰만 볼 수 있으므로 일부 기술에 대한 전체 문서를 보지 못할 수 있습니다. 특히 방대한 양의 문서가 포함된 크고 복잡한 스택의 경우 더욱 그렇습니다.
그렇게 빠르지는 않습니다. Gemini 1.5 Pro(Flash가 아님)를 사용하고 있고, 여기에 많은 문서를 업로드하고 있어서 응답을 받는 데 시간이 걸릴 수 있습니다. 특히 첫 번째 쿼리의 경우, 서버가 API에 문서를 업로드해야 하므로 시간이 더 걸릴 수 있습니다.

특징

클라이언트가 모호하거나 덜 알려진 기술을 포함하여 임의의 수의 기술에 대한 학습 및 디버깅을 수행할 수 있는 "의사에게 문의" 접근 방식을 취할 수 있습니다.
Gemini API를 사용하여 문서에 대한 질문에 답합니다.
문서를 쿼리하기 위한 다양한 도구를 지원합니다.
- can_x_be_done : 특정 작업이 주어진 기술로 수행될 수 있는지 확인합니다.
- hints_for_problem : 특정 문제를 해결하기 위한 힌트를 얻습니다.
- is_this_good_practice : 코드 조각이 모범 사례를 따르는지 확인합니다.
- how_to_do_x : 특정 작업에 대한 예와 대안적 접근 방식을 알아보세요.
디버깅을 위한 로깅 시스템을 제공합니다( --verbose 플래그로 활성화).

시작하기

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Gemini Docs Server를 자동으로 설치하려면:

지엑스피1

이 MCP 서버는 클라이언트에 의해 자동으로 시작되고 관리됩니다. 이를 활성화하려면 설정 파일(예: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json )에서 구성해야 합니다. 일반적으로 클라이언트에는 설정 파일을 여는 버튼이 있습니다.

이 서버의 구성은 다음과 같습니다.

{
  "command": "bun",
  "args": [
    "--watch",
    "path/to/repo/cosa-sai-mcp/src/index.ts",
    "--verbose"
  ],
  "env": {
    "GEMINI_API_KEY": "<your_gemini_api_key>"
  },
  "disabled": false,
  "alwaysAllow": [
    "can_x_be_done",
    "hints_for_problem",
    "is_this_good_practice",
    "how_to_do_x"
  ],
  "timeout": 60 // in seconds
}

지식 기반 조달 및 정리

이 MCP 서버는 질문에 답변하기 위해 문서 지식 기반이 필요합니다. 공개 저장소를 다운로드하거나, 웹사이트를 스크래핑하거나, 다른 방법을 사용하여 이 지식 기반을 직접 확보해야 합니다.

원본 문서에서 스타일 및 기타 불필요한 내용을 정리하기 위해 선택적 정리 프로세스를 수행할 수 있습니다.

이를 위한 몇 가지 기본 도구는 다음과 같습니다. 더 나은 해결책을 권장합니다.

순진한 스크래퍼:

wget --mirror --convert-links --adjust-extension --page-requisites --no-parent --directory-prefix=./local_copy --no-verbose --show-progress $1

빠르고 간편한 마크다운 변환:

#!/bin/bash

directory="${1:-.}"  # Default to current directory if no argument is provided
output_file="${2:-concatenated.md}"  # Default output file name

echo "Concatenating files in '$directory' into '$output_file'..."

# Clear output file if it exists
truncate -s 0 "$output_file"

# Find all files (excluding directories) and process them
find "$directory" -type f -name '*.html' | while IFS= read -r file; do
    echo "=== ${file#./} ===" >> "$output_file"
    cat "$file" \
    | grep -v 'base64' \
    | html2markdown >> "$output_file"
    echo -e "\n" >> "$output_file"
done

echo "Done! Output saved to '$output_file'"

용법

이 서버는 다음과 같은 도구를 제공합니다.

can_x_be_done: 특정 작업이 주어진 기술에서 수행될 수 있는지 확인합니다.
- 입력: docs , prompt , x , technology
- 출력: success , data
hints_for_problem: 특정 문제를 해결하기 위한 힌트를 얻습니다.
- 입력: docs , prompt , problem , context , environment
- 출력: success , data
is_this_good_practice: 코드 조각이 모범 사례를 따르는지 확인합니다.
- 입력: docs , prompt , snippet , context
- 출력: success , data
how_to_do_x: 특정 작업에 대한 예와 대체 접근 방식을 보여줍니다.
- 입력: docs , prompt , x , technology
- 출력: success , data

기여하다

여러분의 참여를 환영합니다! 다음 지침을 따라주세요.

저장소를 포크합니다.
기능이나 버그 수정을 위해 새로운 브랜치를 만듭니다.
변경 사항을 적용하고 설명적인 커밋 메시지로 커밋합니다.
풀 리퀘스트를 제출하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

부인 성명

이 버전은 프로젝트의 초기 버전이므로 버그와 제한 사항이 있을 수 있습니다. 발견하신 문제는 알려주시고, 개선 사항이나 새로운 기능을 제안해 주시면 감사하겠습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Gemini API를 통해 큐레이팅된 문서에 대한 액세스를 제공하여 사용자가 컨텍스트 및 검색 제한을 극복하여 기술 문서를 효과적으로 쿼리하고 상호 작용할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Gemini Docs MCP Server