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):