🤖 클로드 AI 문서 작성 보조원 📚

Claude에 문서 검색 기능을 제공하는 강력한 MCP 서버

✨ 특징

🔍 스마트 문서 검색 - 여러 AI/ML 라이브러리 문서 검색
🧠 Claude 통합 - Claude의 고급 추론 기능과 원활하게 연결
🌐 지능형 웹 검색 - 타겟 문서 조회를 위해 Serper API 활용
💨 빠른 응답 시간 - 빠른 검색 및 처리를 위해 최적화됨
🧩 확장 가능한 아키텍처 - 더 많은 문서 소스를 쉽게 추가할 수 있습니다.

📋 필수 조건

🐍 Python 3.8 이상
🔑 클로드 프로 구독
🔐 Serper API 키 ( 여기서 받으세요 )
💻 클로드 데스크톱 애플리케이션

🚀 빠른 시작

1️⃣ 설치

지엑스피1

2️⃣ 구성

API 키로 프로젝트 루트에 .env 파일을 만듭니다.

SERPER_API_KEY=your_serper_api_key_here

3️⃣ MCP 서버 시작

python main.py

서버가 실행 중이며 Claude의 연결을 기다리고 있다는 출력이 표시됩니다.

4️⃣ Claude 데스크톱 앱 연결

📱 Claude 데스크톱 앱을 엽니다
⚙️ 프로필 아이콘을 클릭하고 "설정"을 선택하세요
🧰 "도구" 섹션으로 이동하세요
➕ "도구 추가"를 클릭하세요
🔗 "로컬 도구에 연결"을 선택하세요
🖥️ 실행 중인 MCP 서버에 연결하려면 프롬프트를 따르세요.
✅ 연결이 성공했는지 확인하세요

🎮 Claude 문서화 도우미 사용하기

연결되면 Claude에게 질문을 하여 문서 검색을 시작할 수 있습니다. 예:

Could you explain how to use FAISS with LangChain? Please search the langchain documentation to help me.

Claude는 자동으로 귀하의 MCP 서버를 사용하여 다음을 수행합니다.

🔍 관련 문서 검색
📥 콘텐츠 검색
🧠 정보를 처리하고 설명합니다.

🔧 후드 아래

📄 코드 구조

claude-docs-assistant/
├── main.py           # MCP server implementation
├── requirements.txt  # Project dependencies
├── .env              # Environment variables (API keys)
└── README.md         # This documentation

🔌 지원 라이브러리

이 도우미는 현재 다음 항목에 대한 문서 검색을 지원합니다.

🦜 랭체인 : python.langchain.com/docs
🦙 LlamaIndex : docs.llamaindex.ai/en/stable
🧠 OpenAI : platform.openai.com/docs

🧩 작동 원리

📡 MCP 서버는 Claude에게 get_docs 도구를 노출합니다.
🔍 호출 시 도구는 Serper API를 사용하여 문서를 검색합니다.
📚 결과는 콘텐츠에 따라 스크래핑됩니다.
🔄 콘텐츠는 분석 및 설명을 위해 Claude에게 반환됩니다.

🛠️ 고급 구성

새로운 문서 소스 추가

main.py 에서 docs_urls 사전을 확장합니다.

docs_urls = {
    "langchain": "python.langchain.com/docs",
    "llama-index": "docs.llamaindex.ai/en/stable",
    "openai": "platform.openai.com/docs",
    "huggingface": "huggingface.co/docs",  # Add new documentation sources
    "tensorflow": "www.tensorflow.org/api_docs",
}

검색 동작 사용자 지정

search_web 함수를 수정하여 결과 수를 조정합니다.

payload = json.dumps({"q": query, "num": 5})  # Increase from default 2

🔍 문제 해결

일반적인 문제

🚫 "연결 거부" 오류 : Claude에 연결하기 전에 MCP 서버가 실행 중인지 확인하세요.
⏱️ 시간 초과 오류 : 인터넷 연결을 확인하거나 시간 초과 값을 늘리세요.
🔒 API 키 문제 : .env 파일에서 Serper API 키가 올바른지 확인하세요.

디버깅 팁

main.py 파일을 수정하여 더 자세한 로깅을 추가하세요.

import logging
logging.basicConfig(level=logging.DEBUG)

📈 성능 최적화

⚡ 더 빠른 응답 시간을 위해 자주 액세스하는 문서를 캐싱하는 것을 고려하세요.
🧠 토큰 제한을 피하기 위해 Claude에게 반환되는 텍스트 양을 제한합니다.
🌐 더욱 구체적인 쿼리를 사용하여 더욱 관련성 있는 문서를 얻으세요

🤝 기여하기

참여를 환영합니다! 다음과 같은 방법으로 도움을 주세요.

🍴 저장소를 포크하세요
🌿 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
💾 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
📤 브랜치에 푸시합니다( git push origin feature/amazing-feature )
🔍 풀 리퀘스트 열기

📜 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

클로드를 창조하는 인류학적
검색 API를 제공하는 Serper.dev
이 프로젝트를 가능하게 하는 모든 오픈 소스 라이브러리

Claude AI Documentation Assistant

Integrations