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

Related MCP server: Desktop Commander MCP

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

1. 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

2. Instalar dependencias

   pip install -r requirements.txt

3. Configurar el entorno

   # Copy environment template
   cp .env.example .env
   
   # Edit .env and add your API key
   ANTHROPIC_API_KEY=your_api_key_here

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

1. Uso habitual del escritorio de Claude

   • Simplemente chatea normalmente con Claude

   • Utiliza tu Plan Profesional

   • No se necesitan comandos especiales

2. Uso de la API

   @claude-api Please answer using the API: What is the capital of France?

Funciones avanzadas

1. Uso de los avisos del sistema

   @claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan

2. 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

1. query_claude

   • Realizar llamadas API directas a Claude

   • Soporte para indicaciones del sistema

   • Seguimiento de conversaciones

2. clear_conversation

   • Restablecer el historial de conversaciones

   • Administrar múltiples hilos de conversación

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

1. 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

2. Problemas de conexión

   • Compruebe si el servidor MCP se está ejecutando

   • Verificar el entorno de Python

   • Consultar los registros de Claude Desktop

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

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Enviar una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Apoyo

Para problemas y preguntas:

1. Abrir un problema en el repositorio

2. Consultar las discusiones existentes

3. Revise la guía de solución de problemas