🤖 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

Related MCP server: Volcengine Knowledge Base MCP

📋 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

1. 📱 Abra la aplicación de escritorio Claude

2. ⚙️ Haz clic en el icono de tu perfil y selecciona "Configuración"

3. 🧰 Navega hasta la sección "Herramientas"

4. ➕ Haga clic en "Agregar herramienta"

5. 🔗 Seleccione "Conectarse a una herramienta local"

6. 🖥️ Siga las instrucciones para conectarse a su servidor MCP en ejecución

7. ✅ 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:

1. 🔍Buscar documentación relevante

2. 📥 Recuperar el contenido

3. 🧠 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

1. 📡 El servidor MCP expone una herramienta get_docs a Claude

2. 🔍 Cuando se invoca, la herramienta busca documentación utilizando la API de Serper

3. 📚 Los resultados se extraen de su contenido

4. 🔄 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:

1. 🍴 Bifurcar el repositorio

2. 🌿 Crea una rama de características ( git checkout -b feature/amazing-feature )

3. 💾 Confirma tus cambios ( git commit -m 'Add some amazing feature' )

4. 📤 Empujar a la rama ( git push origin feature/amazing-feature )

5. 🔍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