imagen

Servidor MCP Beehiiv

Name: Beehiiv MCP Server
Author: reymerekar7

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)

Related MCP server: Couchbase MCP Server for LLMs

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)

obtener_contenido_de_la_publicación

Recupera el contenido HTML completo de una publicación.

crear_nueva_publicación

Crea una nueva publicación en la plataforma beehiiv (solo para empresas)

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