🤖 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

python main.py

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

Claude AI Documentation Assistant

Integrations