Servidor MCP de análisis de código
Un servidor de Protocolo de Contexto de Modelo (MCP) que permite que los modelos de IA comprendan y analicen bases de código a través de conversaciones en lenguaje natural.
✨ Aspectos destacados
- Exploración de código natural : haga preguntas de alto nivel sobre su base de código
"What are all the different payment providers integrated in the system?"
- Comprensión profunda del código : extraiga información sobre los modelos de datos y la arquitectura del sistema
"How does the user authentication flow work from frontend to database?"
- Análisis dinámico : rastrear flujos de datos y comprender las relaciones del sistema
"Show me all the places where we calculate transaction fees"
Limitaciones
Esta herramienta es una alternativa más sencilla a herramientas de análisis de código más sofisticadas, como Aider . Si bien carece de las capacidades avanzadas de análisis de código y la robustez de herramientas como Aider, ofrece una solución ligera para la exploración de la base de código si ya cuenta con una suscripción a Claude Pro. Sus principales ventajas son:
- Rentable : usar su suscripción existente a Claude Pro significa que no hay costos de API adicionales, a diferencia de las herramientas que pueden resultar costosas al analizar grandes bases de código.
- Configuración sencilla : inicio rápido con una configuración mínima
- Análisis básico : útil para la comprensión y exploración de código de alto nivel.
Tenga en cuenta que debido a su enfoque más simple para el análisis de código, puede cometer más errores o proporcionar información menos detallada en comparación con herramientas más especializadas.
🚀 Inicio rápido
- Instalar el servidor:
git clone https://github.com/saiprashanths/code-analysis-mcp.git
cd code-analysis-mcp
- Instalar la aplicación Claude Desktop . Para obtener más instrucciones sobre cómo configurar un servidor MCP con la aplicación Claude Desktop, consulte la documentación.
- Configure el servidor en el archivo de configuración de Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Ventanas:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"code-analysis": {
"command": "uv",
"args": [
"--directory",
"/PATH/TO/YOUR/REPO",
"run",
"code_analysis.py"
]
}
}
}
- ¡Reinicie Claude Desktop y comience a analizar su código!
- Asegúrese de que la herramienta esté configurada correctamente
- Al hacer clic en el icono de herramientas deberían mostrarse las herramientas
code-analysis - Al hacer clic en el botón de integraciones debería aparecer el mensaje
analyze_code_repository
💡 Ejemplo de uso
A continuación se explica cómo puede utilizar la herramienta para comprender una base de código compleja:
Comience haciendo clic en el mensaje analyze_code_repository que se muestra a continuación. Esto le guiará a través del proceso para inicializar el repositorio y comenzar.
You: How does the transaction processing work in this system?
Claude: Let me analyze the data flow for transactions.
Looking at the codebase, I can see that transaction processing happens through several key components:
1. Raw transaction data is captured in the `TransactionEvent` model with fields for:
- Payment status
- Amount
- Fee calculations
- Processing timestamps
2. This data is then processed through the PaymentSummary model, which:
- Validates payment provider responses
- Calculates processing fees
- Records transaction status
Would you like me to explain any part of this in more detail?
You: What are the key database tables involved?
Claude: The main tables in the transaction processing pipeline are:
1. transaction_events: Stores raw payment events
2. payment_summary: Processed transaction records
3. payment_providers: Provider configuration
4. merchant_accounts: Account-specific settings
Let me know if you'd like to see the schema for any of these tables!
🔧 Herramientas disponibles
inicializar_repositorio
Inicializar un repositorio de código para su análisis:
initialize_repository("/path/to/repo")
# Output: Successfully initialized code repository at: /path/to/repo
Recuperar información sobre el repositorio inicializado:
get_repo_info()
# Output:
# Code Repository Information:
# Path: /path/to/repo
# Exists: True
# Is Directory: True
# Found .gitignore file
obtener_estructura_del_repositorio
Examinar la estructura de archivos del repositorio:
get_repo_structure(depth=2)
# Output:
# 📁 src/
# 📁 api/
# 📄 routes.py
# 📄 models.py
# 📁 utils/
# 📄 helpers.py
# 📄 main.py
leer_archivo
Leer y analizar archivos específicos:
read_file("src/api/models.py")
# Output:
# File: src/api/models.py
# Language: python
# Size: 2.3 KB
#
# [File contents...]
⚙️ Detalles técnicos
- Profundidad de escaneo predeterminada: 3 niveles
- Tamaño máximo de archivo: 1 MB
- Máximo de líneas por archivo: 1000
- Ignora las rutas enumeradas en .gitignore
- Solo acceso al sistema de archivos local
- Valida las rutas de archivos para evitar el cruce de directorios
📝 Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.