Beehiiv MCP サーバー
Beehiiv API v2と連携するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、大規模言語モデル（LLM）は標準化されたツールを通じてBeehiivの出版物や投稿と連携できるようになります。
前提条件
Python 3.10以上
uvパッケージマネージャーAPIアクセス可能なBeehiivアカウント
Claude Desktop（または他のMCP互換クライアント）
Related MCP server: Couchbase MCP Server for LLMs
インストール
まだインストールしていない場合は、
uvをインストールします。
最初から再構築する場合は、プロジェクトを作成して設定します。
プロジェクト ルートに
.envファイルを作成します。
クロードデスクトップ構成
Claude Desktop 構成ファイル ( ~/Library/Application Support/Claude/claude_desktop_config.json ) に次のコードを追加します。
交換する：
<ABSOLUTE_UV_PATH>はuv実行ファイルへのパスです<ABSOLUTE_SERVER_PATH>、beehiiv_server.pyファイルへの絶対パスです。
利用可能なツール
この MCP サーバーは現在、次のツールを公開しています (今後さらに追加される予定です)。
出版物リスト
API キーでアクセスできるすべての出版物を一覧表示します。
リスト投稿
特定の出版物の最新の確認済み投稿 5 件を一覧表示します。
取得投稿
特定の投稿に関する詳細情報を取得します。
get_post_content
投稿の完全なHTMLコンテンツを取得します
新しい投稿を作成
beehiiv プラットフォームに新しい投稿を作成します (エンタープライズのみ)
仕組み
Claude Desktop を通じてこのサーバーとやり取りする場合:
クライアントがあなたの質問をクロードに送ります
クロードは利用可能なBeehiivツールを分析し、どのツールを使用するかを決定します。
クライアントは、このMCPサーバーを介して選択されたツールを実行します。
結果はクロードに送り返される
クロードは自然言語で応答する
応答が表示されます
（ビデオは近日公開予定）
トラブルシューティング
クロードにサーバーが表示されない
claude_desktop_config.jsonファイルの構文を確認してくださいすべてのパスが相対パスではなく絶対パスであることを確認する
Claudeデスクトップを再起動します
ログの表示
MCP 関連の問題については、Claude のログを確認してください。
ログは次の場所に保存されます:
一般的な 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 )