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

Related MCP server: Jilebi

¿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

"mcpServers": {
  "beeminder": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-beeminder",
      "run",
      "mcp-beeminder"
    ],
    "env": {
        "BEEMINDER_API_KEY": "YOUR_BEEMINDER_API_KEY,
        "BEEMINDER_USERNAME": "YOUR_BEEMINDER_USERNAME"
    }
  }
}

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!