Servidor MCP Beehiiv

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API Beehiiv v2. Este servidor permite que los Modelos de Lenguaje Grandes (LLM) interactúen con las publicaciones y entradas de Beehiiv mediante herramientas estandarizadas.

Prerrequisitos

Python 3.10 o superior
administrador de paquetes uv
Una cuenta Beehiiv con acceso API
Claude Desktop (u otro cliente compatible con MCP)

Instalación

Instale uv si aún no lo ha hecho:

curl -LsSf https://astral.sh/uv/install.sh | sh

Si va a reconstruir desde cero, cree y configure su proyecto:

# Create a new directory and navigate into it
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx python-dotenv

Cree un archivo .env en la raíz del proyecto:

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

Configuración del escritorio de Claude

Agregue lo siguiente a su archivo de configuración de Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "beehiiv-mcp-server": {
      "command": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ]
    }
  }
}

Reemplazar:

<ABSOLUTE_UV_PATH> con la ruta a su ejecutable uv
<ABSOLUTE_SERVER_PATH> con la ruta absoluta a su archivo beehiiv_server.py

Herramientas disponibles

Este servidor MCP actualmente expone las siguientes herramientas (se agregarán más):

lista_publicaciones

Enumera todas las publicaciones accesibles con su clave API.

lista_de_publicaciones

Enumera las 5 publicaciones confirmadas más recientes para una publicación determinada.

list_posts(publication_id: str)

obtener_publicación

Recupera información detallada sobre una publicación específica.

get_post(publication_id: str, post_id: str)

Cómo funciona

Cuando interactúas con este servidor a través de Claude Desktop:

El cliente envía su pregunta a Claude
Claude analiza las herramientas Beehiiv disponibles y decide cuál(es) utilizar
El cliente ejecuta las herramientas elegidas a través de este servidor MCP
Los resultados se envían a Claude.
Claude formula una respuesta en lenguaje natural
La respuesta se te muestra

(próximamente vídeo)

Solución de problemas

El servidor no aparece en Claude

Comprueba la sintaxis de tu archivo claude_desktop_config.json
Asegúrese de que todas las rutas sean absolutas, no relativas
Reiniciar Claude Desktop

Visualización de registros

Consulte los registros de Claude para detectar problemas relacionados con MCP:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Los registros se almacenan en:

~/Library/Logs/Claude/mcp.log para conexiones generales de MCP
~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log para registros específicos del servidor

Seguridad

Nunca envíe su archivo .env al control de versiones
Mantenga segura su clave API de Beehiiv
Considere implementar una limitación de velocidad para las llamadas API

Contribuyendo

hmu en X ( https://x.com/reymerekar7 )

Beehiiv MCP Server

Integrations