Beehiiv MCP サーバー

Beehiiv API v2と連携するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、大規模言語モデル（LLM）は標準化されたツールを通じてBeehiivの出版物や投稿と連携できるようになります。

前提条件

Python 3.10以上
uvパッケージマネージャー
APIアクセス可能なBeehiivアカウント
Claude Desktop（または他のMCP互換クライアント）

インストール

まだインストールしていない場合は、 uvをインストールします。

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

最初から再構築する場合は、プロジェクトを作成して設定します。

# 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

プロジェクトルートに.envファイルを作成します。

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

クロードデスクトップ構成

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>"
      ]
    }
  }
}

交換する：

<ABSOLUTE_UV_PATH>はuv実行ファイルへのパスです
<ABSOLUTE_SERVER_PATH> 、 beehiiv_server.pyファイルへの絶対パスです。

利用可能なツール

この MCP サーバーは現在、次のツールを公開しています (今後さらに追加される予定です)。

出版物リスト

API キーでアクセスできるすべての出版物を一覧表示します。

リスト投稿

特定の出版物の最新の確認済み投稿 5 件を一覧表示します。

list_posts(publication_id: str)

取得投稿

特定の投稿に関する詳細情報を取得します。

get_post(publication_id: str, post_id: str)

get_post_content

投稿の完全なHTMLコンテンツを取得します

新しい投稿を作成

beehiiv プラットフォームに新しい投稿を作成します (エンタープライズのみ)

仕組み

Claude Desktop を通じてこのサーバーとやり取りする場合:

クライアントがあなたの質問をクロードに送ります
クロードは利用可能なBeehiivツールを分析し、どのツールを使用するかを決定します。
クライアントは、このMCPサーバーを介して選択されたツールを実行します。
結果はクロードに送り返される
クロードは自然言語で応答する
応答が表示されます

（ビデオは近日公開予定）

トラブルシューティング

クロードにサーバーが表示されない

claude_desktop_config.jsonファイルの構文を確認してください
すべてのパスが相対パスではなく絶対パスであることを確認する
Claudeデスクトップを再起動します

ログの表示

MCP 関連の問題については、Claude のログを確認してください。

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

ログは次の場所に保存されます:

一般的な MCP 接続については~/Library/Logs/Claude/mcp.log
サーバー固有のログについては、 ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log

安全

.envファイルをバージョン管理にコミットしないでください
Beehiiv APIキーを安全に保管してください
API呼び出しのレート制限の実装を検討する

貢献

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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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.

大規模言語モデル (Claude など) が標準化されたツールと Beehiiv API v2 を通じて Beehiiv の出版物や投稿と対話できるようにするモデルコンテキストプロトコルサーバー。

Related MCP Servers

OpenAPI MCP Server
ivo-toby
-
security
A
license
-
quality
A server that enables Large Language Models to discover and interact with REST APIs defined by OpenAPI specifications through the Model Context Protocol.
Last updated -
378
96
TypeScript
MIT License
Astra DB MCP Serverofficial
datastax
A
security
A
license
A
quality
A Model Context Protocol server that allows Large Language Models to interact with Astra DB databases, providing tools for managing collections and records through natural language commands.
Last updated -
10
115
12
TypeScript
Apache 2.0
Jira MCP Server
ParasSolanki
A
security
A
license
A
quality
A Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.
Last updated -
5
87
2
TypeScript
MIT License
MCP TapData Serverofficial
tapdata
-
security
F
license
-
quality
A 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 -

View all related MCP servers

Beehiiv MCP Server