blogger-mcp-server

=======

Blogger 用 MCP サーバー

Claude のような人工知能モデルが Google の Blogger API と直接対話できるようにする Model Context Protocol (MCP) サーバー。

について

このプロジェクトは、Google の Blogger API 用の Model Context Protocol (MCP) 準拠サーバーを実装します。これにより、Claude のような AI モデルが Blogger ブログと対話して次のことが可能になります。

• ブログの一覧表示と取得

• 投稿の一覧表示、検索、取得、作成、更新、削除

• ラベルの一覧表示と取得

重要な注意: Google の Blogger API では、API 経由で新しいブログを作成することはできません。この制限は Google によって文書化されています。ブログは、Blogger の Web インターフェースを通じて手動で作成する必要があります。

Related MCP server: Blogger MCP Server

前提条件

• 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、タイトル「新しい投稿」、コンテンツ「これが私の投稿の内容です」で新しい投稿を作成してください。」

• 「私のブログで「テクノロジー」という単語を含む投稿を検索する」

• 「ID 789012 の投稿を更新して、タイトルを「新しいタイトル」に変更します」

展開オプション

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 : アダプタをサーバーレスフレームワークとして使用する

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 の Web インターフェースを通じて手動で作成する必要があります。

• 投稿検索: Blogger API では、検索用の直接的なエンドポイントは提供されません。この機能は、投稿を取得してフィルタリングすることでクライアント側で実装されます。

• ラベル管理: Blogger API は、ラベル管理用の直接的なエンドポイントを提供しません。この機能は、投稿からラベルを抽出することによって実装されます。

• 認証: このサーバーは API キー認証のみを使用し、公開ブログまたは明示的にアクセスを設定したブログへのアクセスを制限します。

貢献

貢献を歓迎します!お気軽に問題やプルリクエストを開いてください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

cf72ca4 (新機能の追加)