Servidor MCP de Karakeep (Acaparador)

Este proyecto proporciona un servidor compatible con Mind Control Panel (MCP) que permite interacciones (búsqueda y creación de marcadores) con el servicio de marcadores Karakeep a través de su API.

Está diseñado para ser utilizado por modelos de lenguaje grandes (LLM) u otros clientes capaces de realizar solicitudes HTTP de acuerdo con el protocolo MCP definido por servicios como Glama.ai .

Características

• Buscar marcadores: encuentre marcadores existentes en Karakeep basándose en una cadena de consulta.
• Crear marcadores: agregue nuevos marcadores a Karakeep con una URL y un título/descripción opcional.
• Punto final compatible con MCP: expone un único punto final /mcp para acciones.
• Configuración de variables de entorno: configure de forma segura su clave API de Hoarder.

Prerrequisitos

• Python 3.8+
• Una cuenta de Karakeep y una clave API ( consulte la documentación de la API de Karakeep )
• Acceso a una plataforma de alojamiento (por ejemplo, Render, Heroku, Fly.io, VPS) o Docker para la implementación.

Configuración y desarrollo local

1. Clonar el repositorio:
   git clone <your-repository-url> cd hoarder-mcp-server
2. Crear un entorno virtual (recomendado):
   python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
3. Instalar dependencias:
   pip install -r requirements.txt
4. Configurar variables de entorno:
   • Cree un archivo llamado .env en la raíz del proyecto.
   • Agregue su clave API de Hoarder:
     HOARDER_API_KEY="YOUR_HOARDER_API_KEY_HERE"
   • Importante: asegúrese de que .env esté incluido en su archivo .gitignore para evitar confirmar secretos.
5. Ejecute el servidor localmente:
   uvicorn main:app --reload --port 8000
   El servidor estará disponible en http://127.0.0.1:8000 . El indicador --reload reinicia automáticamente el servidor al detectar cambios en el código.

Uso de la API

El servidor expone un único punto final POST: /mcp .

Cuerpo de la solicitud (JSON):