🤖 Asistente de documentación de Claude AI 📚
Un potente servidor MCP que potencia a Claude con capacidades de búsqueda de documentación
✨ Características
- 🔍 Búsqueda inteligente de documentación : busque en múltiples documentos de bibliotecas de IA/ML
- 🧠 Integración de Claude : conexión perfecta con las capacidades de razonamiento avanzadas de Claude
- 🌐 Búsqueda web inteligente : aprovecha la API de Serper para la búsqueda de documentación específica
- 💨 Tiempos de respuesta rápidos : optimizados para una recuperación y procesamiento rápidos
- 🧩 Arquitectura extensible : agregue fácilmente más fuentes de documentación
📋 Requisitos previos
- 🐍 Python 3.8 o superior
- 🔑 Suscripción a Claude Pro
- Clave API de Serper ( Obtén una aquí )
- 💻 Aplicación de escritorio Claude
🚀 Inicio rápido
1️⃣ Instalación
# Clone the repository
git clone https://github.com/your-username/claude-docs-assistant.git
cd claude-docs-assistant
# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
2️⃣ Configuración
Crea un archivo .env en la raíz del proyecto con tus claves API:
SERPER_API_KEY=your_serper_api_key_here
3️⃣ Iniciar el servidor MCP
Debería ver un resultado que indique que el servidor está ejecutándose y esperando que Claude se conecte.
4️⃣ Conectar la aplicación de escritorio de Claude
- 📱 Abra la aplicación de escritorio Claude
- ⚙️ Haz clic en el icono de tu perfil y selecciona "Configuración"
- 🧰 Navega hasta la sección "Herramientas"
- ➕ Haga clic en "Agregar herramienta"
- 🔗 Seleccione "Conectarse a una herramienta local"
- 🖥️ Siga las instrucciones para conectarse a su servidor MCP en ejecución
- ✅ Confirmar que la conexión es exitosa
🎮 Cómo usar el asistente de documentación de Claude
Una vez conectado, puedes empezar a hacerle preguntas a Claude que activarán la búsqueda de documentación. Por ejemplo:
Could you explain how to use FAISS with LangChain? Please search the langchain documentation to help me.
Claude utilizará automáticamente su servidor MCP para:
- 🔍Buscar documentación relevante
- 📥 Recuperar el contenido
- 🧠 Procesar y explicar la información
🔧 Bajo el capó
📄 Estructura del código
claude-docs-assistant/
├── main.py # MCP server implementation
├── requirements.txt # Project dependencies
├── .env # Environment variables (API keys)
└── README.md # This documentation
🔌 Bibliotecas compatibles
Actualmente el asistente admite la búsqueda de documentación para:
- 🦜 LangChain :
python.langchain.com/docs - 🦙 LlamaIndex :
docs.llamaindex.ai/en/stable - 🧠OpenAI :
platform.openai.com/docs
🧩 Cómo funciona
- 📡 El servidor MCP expone una herramienta
get_docs a Claude - 🔍 Cuando se invoca, la herramienta busca documentación utilizando la API de Serper
- 📚 Los resultados se extraen de su contenido
- 🔄 El contenido se devuelve a Claude para su análisis y explicación.
🛠️ Configuración avanzada
Agregar nuevas fuentes de documentación
Amplíe el diccionario docs_urls en main.py :
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",
}
Personalización del comportamiento de búsqueda
Modifique la función search_web para ajustar el número de resultados:
payload = json.dumps({"q": query, "num": 5}) # Increase from default 2
🔍 Solución de problemas
Problemas comunes
- 🚫 Error "Conexión rechazada" : asegúrese de que el servidor MCP esté en ejecución antes de conectar a Claude
- ⏱️ Errores de tiempo de espera : Verifique su conexión a Internet o aumente el valor del tiempo de espera
- 🔒 Problemas con la clave API : Verifique que su clave API de Serper sea correcta en el archivo
.env
Consejos de depuración
Agregue un registro más detallado modificando el archivo main.py:
import logging
logging.basicConfig(level=logging.DEBUG)
📈 Optimización del rendimiento
- ⚡ Para tiempos de respuesta más rápidos, considere almacenar en caché la documentación a la que se accede con frecuencia
- 🧠 Limita la cantidad de texto devuelto a Claude para evitar limitaciones de tokens
- 🌐 Utilice consultas más específicas para obtener documentación más relevante
🤝 Contribuyendo
¡Agradecemos tus contribuciones! Puedes ayudarnos de la siguiente manera:
- 🍴 Bifurcar el repositorio
- 🌿 Crea una rama de características (
git checkout -b feature/amazing-feature ) - 💾 Confirma tus cambios (
git commit -m 'Add some amazing feature' ) - 📤 Empujar a la rama (
git push origin feature/amazing-feature ) - 🔍Abrir una solicitud de extracción
📜 Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
🙏 Agradecimientos
- Antrópico por crear a Claude
- Serper.dev para su API de búsqueda
- Todas las bibliotecas de código abierto que hacen posible este proyecto