Beehiiv MCP Server

Beehiiv MCP サーバー

Beehiiv API v2 と連携するためのツールを提供する、Model Context Protocol（MCP）サーバーです。このサーバーにより、LLM は標準化されたツールを通じて Beehiiv の出版物や投稿とやり取りできます。

前提条件

• Python 3.10 以降
• uv パッケージマネージャー
• API にアクセスできる Beehiiv アカウント
• Claude Desktop（またはその他の MCP 対応クライアント）

インストール

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

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

2. 最初から再構築する場合は、プロジェクトを作成してセットアップします：

# 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. プロジェクトのルートに .env ファイルを作成します：

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

Claude Desktop の設定

次の内容を 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 サーバーでは、現在次のツールを利用できます（今後追加予定です）：

list_publications

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

list_posts

指定した出版物の、直近に確認された5件の投稿を一覧表示します。

list_posts(publication_id: str)

get_post

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

get_post(publication_id: str, post_id: str)

get_post_content

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

create_new_post

beehiiv プラットフォームで新しい投稿を作成します（エンタープライズ限定）

仕組み

Claude Desktop を通じてこのサーバーを利用する場合：

1. クライアントが質問を Claude に送信します
2. Claude が利用可能な Beehiiv ツールを分析し、使用するツールを決定します
3. クライアントがこの MCP サーバーを通じて選択されたツールを実行します
4. 結果が Claude に返されます
5. Claude が自然言語で回答を作成します
6. 回答が表示されます

（動画は近日公開）

トラブルシューティング

Claude にサーバーが表示されない場合

1. claude_desktop_config.json ファイルの構文を確認します
2. すべてのパスが相対パスではなく、絶対パスであることを確認します
3. Claude Desktop を再起動します

ログの確認

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 呼び出しにレート制限を実装することを検討してください

コントリビューション

X で気軽にご連絡ください（https://x.com/reymerekar7）