lamatok-mcp

LamaTok（TikTokデータAPI）用MCPサーバー。npmで利用可能: lamatok-mcp。

起動時にLamaTokのOpenAPI仕様からMCPツールを自動生成するため、非推奨ではないすべての GET エンドポイントが手書きのラッパーなしで公開されます。ツールはRESTエンドポイントと1対1で対応します（GET /v1/user/by/username → get_v1_user_by_username）。

100件の無料APIリクエストを獲得

こちらのリンクから登録 すると、100件のLamaTokリクエストが無料になります（クレジットカード不要）。MCPサーバーを接続し、Claude/Cursor/Codexでいくつかプロンプトを試し、契約前にデータ品質を評価するのに十分な量です。

無料の100リクエストはこちらから

クイックスタート

1. lamatok.com でAPIキーを取得します。

2. AIアシスタントにサーバーを追加します。

3. アシスタントに以下のように尋ねます：

   • "@nasaのTikTokプロフィールを取得して。"

   • "user_id 6707206320333226502 の最新動画10件をリストアップして。"

   • "ハッシュタグ photography の最近のTikTok動画を探して。"

Claude Code

claude mcp add lamatok -e LAMATOK_KEY=your-api-key -- npx -y lamatok-mcp

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

Claude Desktopと同じ形式です。アプリのMCP設定ファイルの mcpServers ブロックの下に記述してください。

Zed

~/.config/zed/settings.json に追加します：

{
  "context_servers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex

~/.codex/config.toml に追記します：

[mcp_servers.lamatok]
command = "npx"
args = ["-y", "lamatok-mcp"]

[mcp_servers.lamatok.env]
LAMATOK_KEY = "your-api-key"

ツール

ツールは起動時にライブの LamaTok OpenAPI仕様 から生成されるため、リストは常に現在のAPIと一致します。これらのグループ全体で約19のツールがあります（執筆時点の数）：

各ツール名はエンドポイントを反映しています（GET /v1/user/by/username → get_v1_user_by_username）。アシスタントはMCP経由で tools/list を呼び出し、パラメータスキーマを含む最新の完全なリストを取得できます。/sys、Legacy、System タググループはデフォルトで除外されています。

設定

Legacy、System、/sys タグはデフォルトで除外されます。非推奨の操作もスキップされます。

LAMATOK_URL が api.lamatok.com 以外のホストを指している場合、サーバーは起動時に警告を表示します。キーがそこに送信されるため、自己ホスト型またはプロキシされたLamaTokに対してのみ使用してください。

仕組み

AI Assistant ←stdio→ lamatok-mcp ──https──> api.lamatok.com
                          │
                          └─ fetches /openapi.json once on startup,
                             builds one MCP tool per GET endpoint

ツールの引数はエンドポイントの query および path パラメータにマッピングされます。レスポンスボディはそのまま（JSONテキストとして）返されます。2xx以外のレスポンスは、HTTPステータスとボディを含むツールエラーとして表示されます。

開発

git clone https://github.com/subzeroid/lamatok-mcp.git
cd lamatok-mcp
npm install
npm run build
LAMATOK_KEY=your-key node dist/index.js

ウォッチモードで実行：

LAMATOK_KEY=your-key npm run dev

テストを実行（ユニットテスト + ローカルモックサーバーに対するstdioスモークテスト、ネットワーク/APIキー不要）：

npm test

ライセンス

MIT