🤖 클로드 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 서버 시작
서버가 실행 중이며 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
🙏 감사의 말