blogger-mcp-server

blogger-mcp-server

=======

Blogger 用 MCP サーバー

Claude などの人工知能モデルが Google Blogger API と直接やり取りできる、MCP（Model Context Protocol）サーバーです。

概要

このプロジェクトは、Google Blogger API 用の MCP（Model Context Protocol）互換サーバーを実装しています。Claude などの AI モデルが Blogger のブログと次の操作を行えます。

• ブログの一覧表示と取得
• 投稿の一覧表示、検索、取得、作成、更新、削除
• ラベルの一覧表示と取得

重要な注意事項：Google Blogger API では、API を通じて新しいブログを作成できません。この制限については Google のドキュメントに記載されています。ブログは Blogger のウェブインターフェースから手動で作成する必要があります。

前提条件

• Node.js（バージョン 16 以降）
• Google Blogger API キー

インストール

npm からインストール

npm install -g @mcproadev/blogger-mcp-server

ソースコードからインストール

git clone https://github.com/niyonabil/blogger-mcp-server.git
cd blogger-mcp-server
npm install
npm run build

インストール時にエラーが発生した場合：

npm install --save-dev @types/express @types/socket.io

設定

Blogger API キーを取得する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. Blogger API v3 を有効にします
4. API キーを作成します
5. 設定で使用するため、このキーを控えておきます

MCP サーバーの設定

MCP クライアント用の設定ファイルを作成します。Claude Desktop 用の例を以下に示します。

{
  "mcpServers": {
    "blogger": {
      "command": "npx",
      "args": [
        "-y",
        "@mcproadev/blogger-mcp-server"
      ],
      "env": {
        "BLOGGER_API_KEY": "VOTRE_CLE_API_ICI"
      }
    }
  }
}

VOTRE_CLE_API_ICI を取得した API キーに置き換えてください。

使用方法

ローカルでの起動

このプロジェクトには、サーバーを簡単に起動するためのスクリプトが 2 つ含まれています。

開発モード

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

このスクリプトは、API キーが設定されていることを確認し、必要に応じて依存関係をインストールしてプロジェクトをコンパイルした後、開発モードでサーバーを起動します。

本番モード

export BLOGGER_API_KEY=votre_cle_api
npm run build
./start-prod.sh

このスクリプトは、API キーが設定されていることと、プロジェクトがコンパイル済みであることを確認した後、本番モードでサーバーを起動します。

MCP クライアントでの使用

設定が完了すると、Claude Desktop など、互換性のある任意の MCP クライアントで Blogger 用 MCP サーバーを使用できます。

コマンドの例：

• 「Blogger のブログをすべて一覧表示して」
• 「ID が 123456 のブログに、タイトルが『Mon nouveau post』、本文が『Voici le contenu de mon post』の新しい投稿を作成して」
• 「ブログ内で『technologie』という語句を含む投稿を検索して」
• 「ID が 789012 の投稿のタイトルを『Nouveau titre』に変更して」

デプロイオプション

Vercel へのデプロイ

このプロジェクトには、Vercel へのデプロイを簡単にする vercel.json ファイルが含まれています。

1. まだアカウントをお持ちでない場合は、Vercel でアカウントを作成します
2. Vercel CLI ツールをインストールします：npm install -g vercel
3. Vercel アカウントにログインします：vercel login
4. シークレットの環境変数を設定します：vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
5. プロジェクトをデプロイします：vercel

Docker でのデプロイ

このプロジェクトには、Docker コンテナへのデプロイを簡単にする Dockerfile が含まれています。

1. Docker イメージをビルドします：

   docker build -t blogger-mcp-server .
   

2. コンテナを実行します：

   docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server
   

その他のデプロイオプション

このサーバーは、Node.js に対応したその他のプラットフォームにもデプロイできます。

1. Heroku：Procfile と Heroku の環境変数を使用します
2. AWS Lambda：Serverless Framework などのアダプターを使用します
3. Google Cloud Run：付属の Dockerfile を使用します

プロジェクト構成

Blogger 用 MCP サーバーは、複数のモジュールで構成されています。

• index.ts：メインのエントリーポイント
• server.ts：MCP サーバーの設定
• bloggerService.ts：Blogger API とやり取りするサービス
• config.ts：サーバーの設定
• types.ts：型とインターフェースの定義
• mcp-sdk-mock.ts：依存関係の問題を避けるための、簡易版 MCP SDK の実装

既知の制限事項

• ブログの作成：Google の Blogger API では、API 経由で新しいブログを作成できません。ブログは Blogger のウェブインターフェースから手動で作成する必要があります。
• 投稿の検索：Blogger API には検索用の直接的なエンドポイントがありません。この機能は、投稿を取得してから絞り込むことでクライアント側に実装されています。
• ラベルの管理：Blogger API にはラベル管理用の直接的なエンドポイントがありません。この機能は、投稿からラベルを抽出することで実装されています。
• 認証：このサーバーは API キー認証のみを使用するため、アクセスできるのは公開ブログ、または明示的にアクセスを設定したブログに限られます。

コントリビューション

コントリビューションを歓迎します！お気軽に issue または pull request を作成してください。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

cf72ca4 (新機能の追加)