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)

仕組み

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 )

Beehiiv MCP Server

Integrations