Beehiiv MCP Server

🚀 Beehiiv MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーで、Beehiiv API v2とのインタラクションを可能にするツールを提供します。大型言語モデル（LLMs）が標準化されたツールを通じてBeehiivの出版物や投稿とやり取りできるようになります。

🚀 クイックスタート

🔖 前提条件

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

📦 インストール

1. uv がインストールされていない場合は、以下のコマンドを実行してインストールします。

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

2. プロジェクトを最初から構築する場合は、以下のコマンドを実行してプロジェクトを作成し、設定します。

# 新しいディレクトリを作成し、そのディレクトリに移動します。
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# 仮想環境を作成し、アクティブにします。
uv venv
source .venv/bin/activate

# 依存関係をインストールします。
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を再起動してください。

ログの確認

ClaudeのMCP関連の問題のログを確認するには、以下のコマンドを実行します。

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

ログは以下の場所に保存されます。

• ~/Library/Logs/Claude/mcp.log：一般的なMCP接続ログ
• ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log：サーバー固有のログ

🛡️ セキュリティに関する注意事項

• .env ファイル内にAPIキーなどの機密情報を公開しないでください。
• サーバーが安全なネットワーク環境で実行されていることを確認してください。
• 潜在的なセキュリティホールを防ぐために、定期的に依存関係を更新してください。

🤝 貢献

貢献や問題の報告がある場合は、以下の連絡先にご連絡ください。 [あなたの連絡先]