Linewhiz

LineWhiz

高级 MCP 服务，让 AI Agent 管理 LINE 官方账号。

用户在 Claude / ChatGPT / Cursor 中输入自然语言 → LineWhiz 调用 LINE Messaging API。

功能

工具	套餐	描述
get_account_info	免费	获取 LINE OA 信息：名称、套餐、图片
get_friend_count	免费	获取指定日期的关注者数量
get_message_quota	免费	获取本月剩余消息额度
send_broadcast	专业版	向所有好友发送消息
send_push_message	专业版	向指定用户发送私信
send_multicast	专业版	向多个用户发送消息（最多 500 人）
get_message_delivery_stats	专业版	获取指定日期的消息送达统计
get_user_profile	专业版	获取用户的显示名称、图片等信息
list_rich_menus	专业版	列出此 LINE OA 的所有图文菜单

快速开始

前提条件

• 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/

套餐体系

套餐	价格	每日调用次数	工具
免费	$0/mo	100	账号信息、好友数量、额度
专业版	$15/mo	5,000	+ 消息、图文菜单、数据洞察
商业版	$45/mo	无限	所有工具

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