Linewhiz

LineWhiz

AI エージェントが LINE 公式アカウントを管理できるプレミアム MCP サーバーです。

ユーザーが Claude / ChatGPT / Cursor に自然言語で入力すると、LineWhiz が LINE Messaging API を呼び出します。

機能

ツール	プラン	説明
get_account_info	Free	LINE 公式アカウントの情報（名前、プラン、プロフィール画像）を取得します
get_friend_count	Free	指定した日のフォロワー数を取得します
get_message_quota	Free	今月の残りメッセージ枠を取得します
send_broadcast	Pro	すべての友だちにメッセージを送信します
send_push_message	Pro	特定のユーザーにダイレクトメッセージを送信します
send_multicast	Pro	複数のユーザーにメッセージを送信します（最大500人）
get_message_delivery_stats	Pro	指定した日の配信統計を取得します
get_user_profile	Pro	ユーザーの表示名、プロフィール画像などを取得します
list_rich_menus	Pro	この LINE 公式アカウントのすべてのリッチメニューを一覧表示します

クイックスタート

前提条件

• Python 3.11+
• uv パッケージマネージャー
• LINE Messaging API チャネル（こちらから作成）

セットアップ

# Clone and install
cd linewhiz && uv sync

# Configure environment
cp .env.example .env
# Edit .env → fill in LINE_CHANNEL_ACCESS_TOKEN and LINE_CHANNEL_SECRET

# Run the server
uv run src/server.py

# Test with MCP Inspector
mcp dev src/server.py

# Run tests
uv run pytest

MCP クライアントの設定

MCP クライアントの設定（例：Claude Desktop の claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "linewhiz": {
      "command": "uv",
      "args": ["run", "src/server.py"],
      "cwd": "/path/to/linewhiz",
      "env": {
        "LINE_CHANNEL_ACCESS_TOKEN": "your_token_here",
        "LINE_CHANNEL_SECRET": "your_secret_here",
        "LINEWHIZ_TIER": "pro"
      }
    }
  }
}

プロジェクト構成

linewhiz/
├── CLAUDE.md              # AI coding spec (single source of truth)
├── pyproject.toml
├── Dockerfile
├── docker-compose.yml
├── .env.example
├── src/
│   ├── server.py          # MCP entry point + tool registration
│   ├── config.py          # Env config via pydantic Settings
│   ├── auth/
│   │   ├── api_keys.py    # Key validation (SHA-256)
│   │   └── tiers.py       # Free/Pro/Business gating + rate limits
│   ├── tools/
│   │   ├── account.py     # get_account_info, get_friend_count, get_message_quota
│   │   ├── messaging.py   # send_broadcast, send_push, send_multicast
│   │   ├── richmenu.py    # list/create/set/link rich menus
│   │   ├── insights.py    # get_message_stats, get_user_profile
│   │   ├── automation.py  # [future] auto-reply
│   │   └── reporting.py   # [future] weekly report
│   ├── services/
│   │   ├── line_api.py    # Async LINE API wrapper
│   │   └── flex_builder.py
│   ├── models/
│   │   ├── user.py        # API key + tier models
│   │   └── usage.py       # Usage log model
│   └── db/
│       └── database.py    # SQLite async init + migrations
├── tests/
│   ├── conftest.py
│   ├── test_account.py
│   ├── test_messaging.py
│   ├── test_richmenu.py
│   └── test_auth.py
└── docs/

プラン体系

プラン	価格	1日の呼び出し回数	ツール
Free	月額$0	100	アカウント情報、友だち数、利用枠
Pro	月額$15	5,000	＋メッセージ送信、リッチメニュー、インサイト
Business	月額$45	無制限	すべてのツール

Docker

# Build and run
docker compose up --build

# Or build manually
docker build -t linewhiz .
docker run --env-file .env linewhiz

開発

# Install with dev dependencies
uv sync --all-extras

# Lint
uv run ruff check src/ tests/

# Type check
uv run mypy src/

# Test
uv run pytest -v

ライセンス

MIT