English Français العربية

Torrentclaw MCP

مجتمعي البحث والويب

Search and discover movies and TV shows with torrent links, quality scoring, streaming availability and cast/crew metadata.

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. torrentclaw-mcp
  2. Quick Start
  3. What can it do?
  4. Configuration
  5. Project Structure
  6. Development
  7. About TorrentClaw
  8. Contributing
  9. License

torrentclaw-mcp

Model Context Protocol server for TorrentClaw — giving AI assistants the ability to search movies and TV shows, find torrents with magnet links, check streaming availability, and explore cast/crew metadata.

torrentclaw-mcp is developed by TorrentClaw as part of its open-source ecosystem. It wraps the TorrentClaw API into the MCP standard so that any compatible AI assistant (Claude, GPT, etc.) can access the platform's search and discovery features natively.

Quick Start

npx torrentclaw-mcp

No API key required (optional for higher rate limits).

What can it do?

Tools
ToolDescription
search_contentSearch movies/shows with filters (query, type, genre, year, rating, quality, language, audio, HDR, season, episode, sort). Returns torrents, magnet links, and optional streaming info.
autocompleteType-ahead search suggestions (up to 8 results). Use to validate titles before a full search.
get_popularGet popular content ranked by user clicks
get_recentGet recently added content
get_watch_providersStreaming availability by country (Netflix, Disney+, etc.)
get_creditsCast and director for a title
get_torrent_urlGet .torrent file download URL from info hash
track_interactionTrack user interaction with a torrent (magnet click, download, copy)
submit_scan_requestSubmit a torrent for audio/video quality analysis via TrueSpec
get_scan_statusCheck the status of a torrent scan request
Resources
URIDescription
torrentclaw://statsCatalog statistics (content/torrent counts by source)
Prompts
PromptDescription
search_movieSearch for a movie by title and get torrents + streaming
search_showSearch for a TV show by title and get torrents
whats_newDiscover recently added movies and TV shows
where_to_watchFind where to stream, rent, or buy a title

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"]
    }
  }
}
Claude Code

Add to .mcp.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"]
    }
  }
}
Environment Variables
VariableDefaultDescription
TORRENTCLAW_API_URLhttps://torrentclaw.comBase URL of the TorrentClaw API
TORRENTCLAW_API_KEY(none)Optional API key for authenticated access (higher rate limits)

Project Structure

.
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── config.ts             # Configuration & URL validation
│   ├── api-client.ts         # TorrentClaw API client with caching
│   ├── types.ts              # TypeScript interfaces for API responses
│   ├── prompts.ts            # MCP prompt definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── search-content.ts
│   │   ├── autocomplete.ts
│   │   ├── get-popular.ts
│   │   ├── get-recent.ts
│   │   ├── get-watch-providers.ts
│   │   ├── get-credits.ts
│   │   ├── get-torrent-url.ts
│   │   ├── track-interaction.ts
│   │   └── scan-request.ts
│   ├── formatters/           # Output formatting
│   │   ├── content.ts
│   │   ├── providers.ts
│   │   └── credits.ts
│   └── resources/            # MCP resources
│       └── stats.ts
├── tests/                    # Test suite (vitest)
├── .github/workflows/        # CI/CD (lint, build, test, release)
├── lefthook.yml              # Git hooks (commit lint, prettier, tsc)
├── Makefile                  # Dev workflow (build, test, lint, fmt)
├── CONTRIBUTING.md           # Contribution guidelines
├── LICENSE                   # MIT
└── README.md

Development

git clone https://github.com/torrentclaw/torrentclaw-mcp.git
cd torrentclaw-mcp
make install-tools
make hooks
make build && make test

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

About TorrentClaw

TorrentClaw is an open platform focused on improving the quality and reliability of torrent metadata. Our mission is to make torrent search engines more accurate and the torrent ecosystem healthier — by building tools that verify, enrich, and standardize metadata across the network.

torrentclaw-mcp is part of the TorrentClaw open-source ecosystem, alongside TrueSpec (torrent metadata verification).

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License — see LICENSE for details.

الأسئلة الشائعة

ما هو Torrentclaw MCP؟

Search and discover movies and TV shows with torrent links, quality scoring, streaming availability and cast/crew metadata.

كيف أثبّت Torrentclaw MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Torrentclaw MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Torrentclaw MCP؟

ينشره torrentclaw. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.