Movies Search

Provides multi-source movie and TV resource search with URL validation via MCP, supporting STDIO and SSE modes.

typescript

1

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "seann0824-movies-search-mcp": {
      "command": "npx",
      "args": [
        "@acwink/movies-search-mcp"
      ],
      "env": {
        "PORT": "YOUR_PORT_PLACEHOLDER"
      }
    }
  }
}

You can search multiple video sources for movies and TV shows using a Model Context Protocol (MCP) server. This tool validates links and provides a flexible, MCP-compliant interface you can integrate into AI workflows or applications. It supports STDIO for local usage and SSE for server-sent events in web contexts.

How to use

You run the MCP server locally and connect your MCP client to it. Choose STDIO for straightforward MCP client integration or SSE when you need a streaming connection for a web or UI-based client.

Quick start patterns you can adopt:

Use STDIO mode for MCP clients by executing the MCP server in normal CLI fashion.
Use SSE mode when your client expects a streaming interface and you want real-time updates.

To integrate into your MCP client configuration, reference the server by its MCP name and point to the command that runs the server. This enables your client to start and communicate with the server using MCP messages.

How to install

Prerequisites you need before installation:
- Node.js and npm installed on your machine.

Install the MCP server globally so you can run it from anywhere.

npm install -g @acwink/movies-search-mcp

Alternatively, you can run the server directly with npx for quick testing.

# Default STDIO mode
npx @acwink/movies-search-mcp

# SSE mode
npx @acwink/movies-search-mcp --sse

If you want to run SSE on a specific port, set PORT when starting in SSE mode.

PORT=3001 movies-search-mcp --sse

You can also embed this server in an MCP client configuration to manage startup automatically.

{
  "mcpServers": {
    "movies-search-mcp": {
      "command": "npx",
      "args": ["@acwink/movies-search-mcp"]
    }
  }
}

Additional content

MCP server language and tooling: the server is written in TypeScript and uses npm and npx for setup and execution. It supports both STDIO and SSE transport modes, allowing you to choose the integration style that best fits your application. The project exposes tools to search for media resources and to validate video URLs.

Environment considerations: if you plan to run SSE, you can specify a custom port using the PORT environment variable. No sensitive credentials are required for basic operation.

Security note: run the server in trusted environments and limit exposure when enabling SSE in public-facing contexts.

Troubleshooting tips:
- If the server does not start, ensure Node.js and npm are installed and that you have network access to install dependencies when using npm or npx.
- If you see connection issues in your MCP client, verify that you are using the correct mode (STDIO or SSE) and that the port is accessible for SSE.