Wechat Official Account MCP

🚀 微信公众号 MCP サービス

このプロジェクトは、AI アプリケーションに対して、微信公众号 API を MCP (Model Context Protocol) を通じてシームレスに統合するサービスを提供します。

作者: xwang152-jack xwang152@163.com
更新日: 2025年11月20日

🚀 クイックスタート

本プロジェクトは MCP プロトコルに基づき、Claude Desktop、Cursor、Trae AI などの AI アプリケーションに対して、微信公众号 API のシームレスな統合を提供します。標準化されたツールインターフェースを通じて、AI アプリケーションは微信公众号の素材管理、草稿管理、公開管理などの機能を簡単に利用できます。

現在のバージョン：v1.1.0（CHANGELOG と Release 説明 を参照）

✨ 主な機能

• 🔐 認証管理: 微信公众号の AppID、AppSecret、Access Token を安全に管理します。
• 📁 素材管理: 一時的および恒久的な素材のアップロード、取得、管理を行います。
• 📝 草稿管理: 記事の草稿を作成、編集、管理します。
• 📢 公開管理: 草稿を微信公众号に公開します。
• 💾 ローカルストレージ: SQLite を使用して、設定とデータをローカルに保存します。
• 🔧 MCP 統合: MCP プロトコル標準に完全に互換性があります。
• 🛡️ セキュリティ強化（v1.1.0）: 敏感なフィールドを暗号化して保存し、ログを匿名化することができます。また、クロスオリジンソースのホワイトリストを設定できます。

🔧 技術詳細

技術スタック

• ランタイム: Node.js 18+
• 言語: TypeScript
• プロトコル: MCP (Model Context Protocol)
• データベース: SQLite
• HTTP クライアント: Axios
• パラメータ検証: Zod
• ビルドツール: Vite

📦 インストール

方法一：npx を使用する（推奨）

npx を使用して直接実行し、インストールする必要はありません。

# MCP サーバーを起動する
npx wechat-official-account-mcp mcp -a <your_app_id> -s <your_app_secret>

# 例
npx wechat-official-account-mcp mcp -a wx1234567890abcdef -s your_app_secret_here

⚠️ 重要提示

SSE モードを使用する場合は、CORS_ORIGIN をアクセスを許可するドメインのホワイトリストに設定してください。

方法二：グローバルインストール

# グローバルにインストールする
npm install -g wechat-official-account-mcp

# サービスを起動する
wechat-mcp mcp -a <your_app_id> -s <your_app_secret>

方法三：ローカル開発

# 1. プロジェクトをクローンする
git clone https://github.com/xwang152-jack/wechat-official-account-mcp.git
cd wechat-official-account-mcp

# 2. 依存関係をインストールする
npm install

# 3. プロジェクトをビルドする
npm run build

# 4. サービスを起動する
node dist/src/cli.js mcp -a <your_app_id> -s <your_app_secret>

CLI パラメータの説明

• -a, --app-id <appId>: 微信公众号の AppID（必須）
• -s, --app-secret <appSecret>: 微信公众号の AppSecret（必須）
• -m, --mode <mode>: 転送モード。stdio（デフォルト）と sse をサポートします。
• -p, --port <port>: SSE モードでのポート番号（デフォルトは 3000）
• -h, --help: ヘルプ情報を表示します。

環境変数（一般的なもの）

• CORS_ORIGIN: カンマ区切りのクロスオリジンソースのホワイトリスト（例: https://a.example.com,https://b.example.com）
• WECHAT_MCP_SECRET_KEY: 敏感なフィールドの暗号化保存を有効にする（AES）。設定すると有効になります。

💻 使用例

MCP ツールリスト

1. 認証ツール (wechat_auth)

微信公众号の認証設定と Access Token を管理します。 サポートされる操作:

• configure: AppID と AppSecret を設定します。
• get_token: 現在の Access Token を取得します。
• refresh_token: Access Token を更新します。
• get_config: 現在の設定を表示します。

2. 素材アップロードツール (wechat_media_upload)

微信公众号の一時的な素材をアップロードし、管理します。 サポートされる操作:

• upload: 素材（画像、音声、ビデオ、サムネイル）をアップロードします。
• get: 素材情報を取得します。
• list: 一時的な素材の有効期限は 3 日です。恒久的な素材機能の使用をお勧めします。

サポートされる形式:

• 画像: JPG、PNG（サイズは 10MB 以下）
• 音声: MP3、WMA、WAV、AMR（サイズは 10MB 以下、長さは 60 秒以下）
• ビデオ: MP4（サイズは 10MB 以下）
• サムネイル: JPG（サイズは 64KB 以下）

3. 記事内画像アップロードツール (wechat_upload_img)

記事内で使用する画像をアップロードします。素材ライブラリの制限を超えません。 サポートされる操作:

• upload: 画像をアップロードします（ファイルパスまたは base64 データをサポート）

サポートされる形式:

• 画像: JPG、PNG（サイズは 1MB 以下）

特徴:

• 公众号の素材ライブラリの 100000 枚の画像制限を超えません。
• 記事内容の画像に専用です。
• 記事内で直接使用できる画像 URL を返します。

4. 恒久的素材ツール (wechat_permanent_media)

微信公众号の恒久的な素材を管理します。 サポートされる操作:

• add: 恒久的な素材（画像、音声、ビデオ、サムネイル）をアップロードします。
• get: 恒久的な素材を取得します。
• delete: 恒久的な素材を削除します。
• list: 素材リストを取得します。
• count: 素材の総数を取得します。

5. 草稿管理ツール (wechat_draft)

微信公众号の記事草稿を管理します。 サポートされる操作:

• add: 新しい草稿を作成します。
• get: 草稿の詳細を取得します。
• delete: 草稿を削除します。
• list: 草稿リストを取得します。
• count: 草稿の総数を取得します。

6. 公開ツール (wechat_publish)

微信公众号の記事公開を管理します。 サポートされる操作:

• submit: 草稿を公開します。
• get: 公開状態を取得します。
• delete: 公開を削除します。
• list: 公開リストを取得します。

AI アプリケーションでの使用方法

Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "wechat-official-account": {
      "command": "npx",
      "args": [
        "wechat-official-account-mcp",
        "mcp",
        "-a", "your_wechat_app_id",
        "-s", "your_wechat_app_secret"
      ]
    }
  }
}

または、グローバルにインストールしたバージョンを使用する場合は、以下のようにします。

{
  "mcpServers": {
    "wechat-official-account": {
      "command": "wechat-mcp",
      "args": [
        "mcp",
        "-a", "your_wechat_app_id",
        "-s", "your_wechat_app_secret"
      ]
    }
  }
}

Cursor / Trae AI

MCP 設定にサーバー設定を追加します。

{
  "mcpServers": {
    "wechat-official-account": {
      "command": "npx",
      "args": [
        "wechat-official-account-mcp",
        "mcp",
        "-a", "your_wechat_app_id",
        "-s", "your_wechat_app_secret"
      ]
    }
  }
}

または、グローバルにインストールしたバージョンを使用する場合は、以下のようにします。

{
  "mcpServers": {
    "wechat-official-account": {
      "command": "wechat-mcp",
      "args": [
        "mcp",
        "-a", "your_wechat_app_id",
        "-s", "your_wechat_app_secret"
      ]
    }
  }
}

開発ガイド

開発モード

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# ローカルで CLI をテストする
node dist/src/cli.js mcp -a test_app_id -s test_app_secret

# 型チェック
npm run check

# コードチェック
npm run lint

ビルドと公開

# プロジェクトをビルドする
npm run build

# ローカルでパッケージをテストする
npm pack

# npm に公開する
npm publish

テスト

# テストを実行する
npm test

# CLI 機能をテストする
node dist/src/cli.js --help

設定説明

環境変数

.env ファイルを作成します。

# 開発モード（オプション）
NODE_ENV=development

# デバッグモード（オプション）
DEBUG=true

# クロスオリジンソースのホワイトリスト（本番環境では必ず設定することをお勧め）
CORS_ORIGIN=https://your-domain.com,https://another-domain.com

# 敏感なフィールドの暗号化を有効にする（設定すると AES 暗号化保存が有効になる）
WECHAT_MCP_SECRET_KEY=your-strong-secret-key

# データベースのパス（オプション、デフォルトは ./data/wechat-mcp.db）
DB_PATH=./data/wechat-mcp.db

微信公众号設定

1. 微信公众平台にログインします。
2. 「開発」->「基本設定」に移動します。
3. AppID と AppSecret を取得します。
4. wechat_auth ツールを使用して設定します。

セキュリティ説明

• 暗号化保存: WECHAT_MCP_SECRET_KEY を設定すると、app_secret/token/encoding_aes_key/access_token は暗号化された形式で永続化されます（enc: 接頭辞が付きます）。
• ログ匿名化: エラーログには状態コードまたはメッセージのみが記録され、レスポンスボディや敏感な情報が漏洩するのを防ぎます。
• クロスオリジンホワイトリスト: 本番環境では必ず CORS_ORIGIN を正確なドメインリストに設定し、* を避けてください。
• パラメータ検証: ツールのパラメータは Zod で検証され、不適切な入力のリスクを低減します。
• キーの提出を避ける: AppSecret、Token などをコードリポジトリやビルド成果物に含めないでください。

貢献ガイド

1. このプロジェクトを Fork します。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュします (git push origin feature/AmazingFeature)
5. Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

🆘 サポート

問題が発生した場合や提案がある場合は、以下の手順を行ってください。

1. Issues ページを確認します。
2. 新しい Issue を作成します。
3. プロジェクトのメンテナに連絡します: xwang152-jack xwang152@163.com

🙏 謝辞

• Model Context Protocol - MCP プロトコル標準
• 微信公众平台 - 微信公众号 API
• Anthropic - Claude Desktop MCP サポート

⚠️ 重要提示

このプロジェクトは学習と開発目的でのみ使用されることを想定しています。微信公众平台の利用規約と関連する法律を遵守してください。