Integración de la API de Claude Desktop a través de MCP
Este proyecto proporciona una implementación de servidor MCP que permite una integración fluida entre Claude Desktop y la API de Claude. Permite superar las limitaciones del Plan Profesional y acceder a funciones avanzadas como avisos personalizados del sistema y gestión de conversaciones.
Características
- Integración directa de la API de Claude a través de MCP
- Seguimiento y gestión del historial de conversaciones
- Soporte de avisos del sistema
- Cambio sin problemas entre el Plan Profesional y el uso de la API
- Fácil configuración con Claude Desktop
Cuándo utilizarlo
- Plan Profesional (predeterminado):
- Conversaciones regulares en Claude Desktop
- Uso básico dentro de los límites del plan
- No se necesita ninguna configuración especial
- Token API (a través de este servidor MCP):
- Cuando necesitas ventanas de contexto más largas
- Para utilizar indicaciones del sistema personalizadas
- Para eludir los límites de velocidad
- Para una gestión avanzada de conversaciones
Instrucciones de configuración
- Clonar el repositorio
# Using VS Code:
# 1. Press Cmd + Shift + P
# 2. Type "Git: Clone"
# 3. Paste: https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
# Or using terminal:
git clone https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
cd Claude_Desktop_API_USE_VIA_MCP
- Instalar dependencias
pip install -r requirements.txt
- Configurar el entorno
# Copy environment template
cp .env.example .env
# Edit .env and add your API key
ANTHROPIC_API_KEY=your_api_key_here
- Configurar Claude Desktop
- macOS: Vaya a
~/Library/Application Support/Claude/# Using Finder:
# 1. Press Cmd + Shift + G
# 2. Enter: ~/Library/Application Support/Claude/
- Windows: navegue a
%APPDATA%\Claude\ - Crear o editar
claude_desktop_config.json - Copiar el contenido de
config/claude_desktop_config.json - Actualizar rutas y claves API
Guía de uso
Uso básico
- Uso habitual del escritorio de Claude
- Simplemente chatea normalmente con Claude
- Utiliza tu Plan Profesional
- No se necesitan comandos especiales
- Uso de la API
@claude-api Please answer using the API: What is the capital of France?
Funciones avanzadas
- Uso de los avisos del sistema
@claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan
- Gestionar conversaciones
# Start a new conversation
@claude-api {"conversation_id": "project1"} Let's discuss Python
# Continue same conversation
@claude-api {"conversation_id": "project1"} Tell me more
# View conversation history
@claude-api get_conversation_history project1
# Clear conversation
@claude-api clear_conversation project1
Gestión de costes
- Las llamadas API utilizan sus créditos de API de Anthropic y pueden generar cargos
- Utilice el Plan Profesional para consultas regulares
- Utilice @claude-api solo cuando necesite específicamente:
- Ventanas de contexto más largas
- Indicaciones del sistema personalizadas
- Para eludir los límites de velocidad
Herramientas MCP disponibles
query_claude- Realizar llamadas API directas a Claude
- Soporte para indicaciones del sistema
- Seguimiento de conversaciones
clear_conversation- Restablecer el historial de conversaciones
- Administrar múltiples hilos de conversación
get_conversation_history- Recuperar registros de conversaciones
- Flujo de conversación de depuración
Desarrollo
La implementación principal del servidor se encuentra en src/claude_api_server.py . Para ampliar la funcionalidad, puede agregar nuevas herramientas mediante el decorador @mcp.tool() .
Ejemplo de adición de una nueva herramienta:
@mcp.tool()
async def custom_tool(param: str) -> str:
"""
Custom tool description
Args:
param: Parameter description
"""
try:
# Tool implementation
return result
except Exception as e:
return f"Error: {str(e)}"
Solución de problemas
- Problemas con la clave API
- Verifique su clave API en .env
- Verifique las rutas de configuración de Claude Desktop
- Asegúrese de que la clave API tenga los permisos correctos
- Problemas de conexión
- Compruebe si el servidor MCP se está ejecutando
- Verificar el entorno de Python
- Consultar los registros de Claude Desktop
- Problemas de uso
- Asegúrese de que la sintaxis de @claude-api sea correcta
- Comprobar los ID de las conversaciones
- Verificar el formato del mensaje del sistema
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Realiza tus cambios
- Enviar una solicitud de extracción
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Apoyo
Para problemas y preguntas:
- Abrir un problema en el repositorio
- Consultar las discusiones existentes
- Revise la guía de solución de problemas