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:
- Si va a reconstruir desde cero, cree y configure su proyecto:
- Cree un archivo
.env
en la raíz del proyecto:
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
):
Reemplazar:
<ABSOLUTE_UV_PATH>
con la ruta a su ejecutableuv
<ABSOLUTE_SERVER_PATH>
con la ruta absoluta a su archivobeehiiv_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.
obtener_publicación
Recupera información detallada sobre una publicación específica.
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:
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 )
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Un servidor de protocolo de contexto de modelo que permite que los modelos de lenguaje grandes (como Claude) interactúen con publicaciones y entradas de Beehiiv a través de herramientas estandarizadas y la API de Beehiiv v2.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.Last updated -
- -securityFlicense-qualityA Model Context Protocol server that enables large language models to interact directly with Couchbase databases through natural language, supporting operations like querying buckets, performing CRUD operations, and executing N1QL queries.Last updated -77TypeScript
- -securityAlicense-qualityA Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.Last updated -14JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that helps large language models process code repositories by providing file tree generation, code merging, and code analysis capabilities.Last updated -321JavaScriptMIT License