tinyrex-mcp

모든 MCP 클라이언트가 Apify에서 27개의 소형 TinyRex 스크래퍼(6개 구인 게시판의 원격 작업, Shopify 스토어 카탈로그 및 앱 감지, 오디오 및 비디오 전사, 기업 등록부, 입찰)를 나열하고 실행할 수 있게 해주는 Python stdio MCP 서버입니다. 자체 APIFY_TOKEN을 사용하며 데이터셋 행을 반환합니다. MIT 라이선스입니다. 제가 만들고 유지 관리합니다.

GitHub
2

문서

tinyrex-mcp

Listed on mcpservers.org

Featured on LaunchIgniter

Run TinyRex Apify Store actors from Claude Desktop, Cursor, and other MCP hosts, using your own APIFY_TOKEN.

This is a thin stdio Model Context Protocol server: it lists the public TinyRex actors and starts a run, then returns dataset items (capped for MCP hosts).

Actors are pay-per-event (PPE) on Apify. Failed or empty runs are often free under TinyRex pricing: check each actor's Store page. You pay Apify with your own account; this MCP does not bill separately.

Install

Python 3.11+:

pip install git+https://github.com/emirmrkaljevic/tinyrex-mcp.git
# or clone and:
# pip install -e .

Requires an Apify API token in the environment as APIFY_TOKEN.

Claude Desktop / Cursor (mcpServers)

{
  "mcpServers": {
    "tinyrex": {
      "command": "tinyrex-mcp",
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

If the script is not on PATH, use the module form:

{
  "mcpServers": {
    "tinyrex": {
      "command": "python",
      "args": ["-m", "tinyrex_mcp"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

Tools

ToolWhat it does
list_actorsLists all 27 public TinyRex actors (name, title, description, Store URL, example input).
run_actorRuns tinyrex/<name> with an input object, waits for the run, returns dataset items (default max 50) plus itemCount, runId, and status.

Example: LEI lookup

  1. list_actors → find gleif-lei-lookup
  2. run_actor with:
{
  "actor": "gleif-lei-lookup",
  "input": { "companyNames": ["Siemens AG"], "maxResultsPerName": 1 },
  "max_items": 5
}

More prompt-to-tool-call examples are in docs/examples.md.

Public actors wrapped

list_actors returns all 27 public TinyRex actors. Store pages:

Private / ToS-blocked actors are not exposed.

Docker (stdio)

docker build -t tinyrex-mcp .
docker run --rm -i -e APIFY_TOKEN=YOUR_APIFY_TOKEN tinyrex-mcp

Development

python -m venv .venv && source .venv/bin/activate
pip install -e .
APIFY_TOKEN=... tinyrex-mcp   # stdio MCP

Unit tests that do not need an Apify token: python -m unittest discover -s tests.

Smoke-test helpers (list tools + one cheap run, needs APIFY_TOKEN) live in scripts/smoke_test.py.

License

MIT. Brand: TinyRex. Store username: tinyrex.