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)

Related MCP server: MCP Python Server — API Wrapper

Instalación

1. Instale uv si aún no lo ha hecho:

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

2. 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

3. 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:

1. El cliente envía su pregunta a Claude

2. Claude analiza las herramientas Beehiiv disponibles y decide cuál(es) utilizar

3. El cliente ejecuta las herramientas elegidas a través de este servidor MCP

4. Los resultados se envían a Claude.

5. Claude formula una respuesta en lenguaje natural

6. La respuesta se te muestra

(próximamente vídeo)

Solución de problemas

El servidor no aparece en Claude

1. Comprueba la sintaxis de tu archivo claude_desktop_config.json

2. Asegúrese de que todas las rutas sean absolutas, no relativas

3. 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 )