lamatok-mcp

LamaTok — TikTok 데이터 API용 MCP 서버입니다. npm에서 이용 가능합니다: lamatok-mcp.

시작 시 LamaTok OpenAPI 사양에서 MCP 도구를 자동으로 생성하므로, 더 이상 사용되지 않는(deprecated) 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 태그는 기본적으로 제외됩니다. 더 이상 사용되지 않는(deprecated) 작업도 건너뜁니다.

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

감시(watch) 모드에서 실행:

LAMATOK_KEY=your-key npm run dev

테스트 실행 (단위 테스트 + 로컬 모의 서버에 대한 stdio 스모크 테스트, 네트워크/API 키 불필요):

npm test

라이선스

MIT