lamatok-mcp

Servidor MCP para LamaTok, la API de datos de TikTok. Disponible en npm: lamatok-mcp.

Autogenera herramientas MCP a partir de la especificación OpenAPI de LamaTok al iniciarse, por lo que cada endpoint GET no obsoleto se expone sin necesidad de envoltorios escritos a mano. Las herramientas se asignan 1:1 a los endpoints REST (GET /v1/user/by/username → get_v1_user_by_username).

Obtén 100 solicitudes de API gratuitas

Regístrate con este enlace y obtén 100 solicitudes gratuitas de LamaTok: no se requiere tarjeta de crédito. Suficiente para conectar el servidor MCP, probar algunos prompts en Claude/Cursor/Codex y evaluar la calidad de los datos antes de comprometerse.

Obtén tus 100 solicitudes gratuitas aquí

Inicio rápido

1. Obtén una clave de API en lamatok.com.

2. Añade el servidor a tu asistente de IA.

3. Pregunta a tu asistente algo como:

   • "Obtén el perfil de TikTok de @nasa."

   • "Lista los últimos 10 vídeos del user_id 6707206320333226502."

   • "Busca vídeos recientes de TikTok para el hashtag photography."

Claude Code

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

Claude Desktop

Añade a claude_desktop_config.json:

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

Cursor / Windsurf

La misma estructura que Claude Desktop: coloca el bloque bajo mcpServers en el archivo de configuración MCP de la aplicación.

Zed

Añade a ~/.config/zed/settings.json:

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

OpenAI Codex

Añade a ~/.codex/config.toml:

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

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

Herramientas

Las herramientas se generan al inicio a partir de la especificación OpenAPI de LamaTok en vivo, por lo que la lista siempre coincide con la API actual. Unas 19 herramientas en estos grupos (tamaños en el momento de escribir esto):

Cada nombre de herramienta refleja su endpoint (GET /v1/user/by/username → get_v1_user_by_username). Tu asistente puede llamar a tools/list a través de MCP para obtener la lista completa y actualizada con los esquemas de parámetros. Los grupos de etiquetas /sys, Legacy y System están excluidos por defecto.

Configuración

Las etiquetas Legacy, System y /sys están excluidas por defecto. Las operaciones obsoletas también se omiten.

Si LAMATOK_URL apunta a un host distinto de api.lamatok.com, el servidor imprime una advertencia al iniciarse; tu clave se enviará allí, así que úsala solo para un LamaTok autoalojado o con proxy.

Cómo funciona

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

Los argumentos de la herramienta se asignan a los parámetros query y path del endpoint. El cuerpo de la respuesta se devuelve tal cual (texto JSON). Las respuestas que no sean 2xx se muestran como errores de la herramienta con el estado HTTP y el cuerpo.

Desarrollo

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

Ejecutar en modo watch:

LAMATOK_KEY=your-key npm run dev

Ejecutar pruebas (pruebas unitarias + pruebas de humo stdio contra un servidor simulado local, no se requiere red/clave de API):

npm test

Licencia

MIT