MCP Beeminder Server

Servidor Beeminder de MCP

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Beeminder .

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que estandariza cómo las aplicaciones proporcionan contexto a los Modelos de Lenguaje Grandes (LLM). Actúa como un puerto USB-C para aplicaciones de IA, proporcionando una forma estandarizada de conectar los modelos de IA a diferentes fuentes de datos y herramientas.

MCP sigue una arquitectura cliente-servidor donde:

• Hosts MCP : programas como Claude Desktop o IDE que desean acceder a datos a través de MCP
• Clientes MCP : clientes de protocolo que mantienen conexiones 1:1 con servidores
• Servidores MCP : programas ligeros que exponen capacidades específicas a través del protocolo estandarizado
• Fuentes de datos locales : los archivos, bases de datos y servicios de su computadora a los que los servidores MCP pueden acceder de forma segura
• Servicios remotos : sistemas externos disponibles a través de Internet a los que los servidores MCP pueden conectarse

¿Qué es Beeminder?

Beeminder es una herramienta para superar la akrasia (actuar en contra de su buen juicio) combinando:

• Autoseguimiento cuantificado
• Retroalimentación visual a través de una "Línea Roja Brillante" (BRL) que muestra su camino de compromiso
• Los riesgos financieros aumentan con cada fracaso
• Compromiso flexible con un "horizonte akrasia" de 7 días

Esta implementación de servidor proporciona acceso compatible con MCP a la API de Beeminder, lo que permite que los asistentes de IA ayuden a los usuarios a administrar sus objetivos de Beeminder, puntos de datos y otras funciones relacionadas.

Características

El servidor proporciona acceso a la funcionalidad principal de Beeminder, que incluye:

• Gestión de objetivos (crear, leer, actualizar, eliminar)
• Gestión de puntos de datos (crear, leer, eliminar)
• Recuperación de información del usuario
• Compatibilidad con todos los tipos de objetivos de Beeminder:
  • Haz más ("hustler")
  • Odómetro ("motociclista")
  • Pérdida de peso ("perdedor de grasa")
  • Ganar peso ("gainer")
  • Bandeja de entrada menos ("inboxer")
  • Haz menos ("bebedor")

Ejecutándose localmente con la aplicación Claude Desktop

Prerrequisitos

Necesitará su clave API y nombre de usuario de Beeminder para ejecutar el servidor. Para obtener su clave API:

1. Iniciar sesión en Beeminder
2. Vaya a https://www.beeminder.com/api/v1/auth_token.json

También necesitarás tener instalado uv . Consulta la documentación de uv para obtener instrucciones de instalación. Puedes usar otra opción, pero deberás cambiar el command en el archivo claude_desktop_config.json .

Instalación manual

1. Clonar este repositorio.
2. Agregue lo siguiente a su archivo claude_desktop_config.json :

• En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• En Windows: %APPDATA%/Claude/claude_desktop_config.json

3. Instale y abra la aplicación de escritorio Claude .
4. Intenta pedirle a Claude que realice alguna operación de lectura/escritura para confirmar la configuración (por ejemplo, enumera tus objetivos de Beeminder). Si hay problemas, usa las herramientas de depuración que se proporcionan en la documentación de MCP aquí .

Expresiones de gratitud

Gracias a @ianm199 por su paquete beeminder-client , en el que se basa este proyecto.

¡Y obviamente gracias al equipo de Beeminder por crear un producto tan fantástico!