Skip to main content
Glama
subzeroid

lamatok-mcp

lamatok-mcp

npm version npm downloads License: MIT

用于 LamaTok(TikTok 数据 API)的 MCP 服务器。可在 npm 上获取:lamatok-mcp

在启动时从 LamaTok OpenAPI 规范自动生成 MCP 工具,因此每个非弃用的 GET 端点都无需手动编写包装器即可公开。工具与 REST 端点一一对应(GET /v1/user/by/usernameget_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 个工具(截至撰写本文时的数量):

工具

示例

v1/user

9

get_v1_user_by_username, get_v1_user_by_id, get_v1_user_medias

v1/media

8

get_v1_media_info_by_id, get_v1_media_comments

v1/hashtag

2

get_v1_hashtag_medias_recent

每个工具名称都反映了其端点(GET /v1/user/by/usernameget_v1_user_by_username)。您的助手可以通过 MCP 调用 tools/list 来获取包含参数模式的完整、最新的列表。默认情况下,/sysLegacySystem 标签组被排除在外。

配置

变量

描述

必需

LAMATOK_KEY

您的 LamaTok 访问密钥(作为 x-access-key 标头发送)

LAMATOK_URL

基础 URL。默认:https://api.lamatok.com

LAMATOK_SPEC_URL

OpenAPI 规范 URL。默认:${LAMATOK_URL}/openapi.json

LAMATOK_TAGS

白名单:仅包含带有这些标签的操作(逗号分隔)

LAMATOK_EXCLUDE_TAGS

黑名单:要排除的其他标签(在 LegacySystem/sys 之上)

LAMATOK_TIMEOUT_MS

API 调用的单次请求超时时间。默认:30000

LAMATOK_SPEC_TIMEOUT_MS

启动时获取规范的超时时间。默认:60000

LAMATOK_MAX_RESPONSE_BYTES

从每个 API 响应中读取的最大字节数。默认:10485760 (10 MB)

LAMATOK_MAX_SPEC_BYTES

从 OpenAPI 规范中读取的最大字节数。默认:8388608 (8 MB)

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

工具参数映射到端点的 querypath 参数。响应正文按原样返回(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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/subzeroid/lamatok-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server