@broville/media-search-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Broville
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @broville/media-search-mcp
+
+MCP server for movie and TV show search via **TMDB API v3**.
+
+## Features
+
+| Tool | What it does |
+|------|--------------|
+| `media_search` | Search **movies + TV + people** together |
+| `media_search_movies` | Search movies only |
+| `media_search_tv` | Search TV shows only |
+| `media_movie_details` | Full movie details (cast, crew, budget, runtime, etc.) |
+| `media_tv_details` | Full TV series details (seasons, networks, status) |
+| `media_tv_season` | Season details + episode list |
+| `media_tv_episode` | Single episode details |
+| `media_trending` | Trending movies/TV (day / week) |
+| `media_genres` | Genre list (movie or TV) |
+| `media_languages` | TMDB supported languages |
+
+## Install
+
+```bash
+npm install -g @broville/media-search-mcp
+```
+
+Or via npx (no install):
+```bash
+npx @broville/media-search-mcp
+```
+
+## Usage
+
+Requires a **TMDB API key**:
+
+1. Get a free key: https://www.themoviedb.org/settings/api
+2. Export as env var:
+
+```bash
+export TMDB_API_KEY=your_tmdb_key
+export TMDB_API_KEY=$(op item get "TMDB API Key" --vault Server --field api-key)
+npx @broville/media-search-mcp
+```
+
+## Hermes Agent config
+
+Add to `~/.hermes/profiles/neo/config.yaml`:
+
+```yaml
+mcp:
+  media-search:
+    command: node
+    args: ["/home/echo/.npm-global/lib/node_modules/@broville/media-search-mcp/dist/index.js"]
+    env:
+      TMDB_API_KEY: "${TMDB_API_KEY}"
+```
+
+## Response format
+
+All results include `poster_url`, `backdrop_url`, and `still_url` (images are constructed with optimal TMDB sizes).
+
+## License
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,293 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { TmdbClient } from './tmdb.js';
+/* ─── Config ─── */
+function getApiKey() {
+    if (process.env.TMDB_API_KEY)
+        return process.env.TMDB_API_KEY;
+    try {
+        const { execSync } = require('child_process');
+        const out = execSync('op item get "TMDB API Key" --vault Server --field api-key 2>/dev/null');
+        return out.toString().trim();
+    }
+    catch {
+        throw new Error('TMDB_API_KEY not set and 1Password TMDB API Key not found.');
+    }
+}
+const client = new TmdbClient(getApiKey());
+/* ─── Helpers ─── */
+function clean(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined && v !== null));
+}
+/* ─── Tool definitions ─── */
+const TOOLS = [
+    {
+        name: 'media_search',
+        description: 'Search movies, TV shows, and people on TMDB (multi-search).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                include_adult: { type: 'boolean', default: false },
+                language: { type: 'string', default: 'en-US' },
+                page: { type: 'number', default: 1 },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'media_search_movies',
+        description: 'Search movies on TMDB.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                year: { type: 'number' },
+                primary_release_year: { type: 'number' },
+                language: { type: 'string', default: 'en-US' },
+                page: { type: 'number', default: 1 },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'media_search_tv',
+        description: 'Search TV shows on TMDB.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string' },
+                first_air_date_year: { type: 'number' },
+                language: { type: 'string', default: 'en-US' },
+                page: { type: 'number', default: 1 },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'media_movie_details',
+        description: 'Get full TMDB movie details by ID. Use append_to_response for credits, videos, recommendations, similar, images, external_ids, keywords, release_dates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                movie_id: { type: 'number' },
+                append: { type: 'string', description: 'e.g. credits,videos,recommendations' },
+                language: { type: 'string', default: 'en-US' },
+            },
+            required: ['movie_id'],
+        },
+    },
+    {
+        name: 'media_tv_details',
+        description: 'Get full TMDB TV series details by ID. Use append_to_response for credits, videos, recommendations, similar, images, external_ids, keywords.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                series_id: { type: 'number' },
+                append: { type: 'string', description: 'e.g. credits,videos' },
+                language: { type: 'string', default: 'en-US' },
+            },
+            required: ['series_id'],
+        },
+    },
+    {
+        name: 'media_tv_season',
+        description: 'Get TMDB season details with episodes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                series_id: { type: 'number' },
+                season_number: { type: 'number' },
+                language: { type: 'string', default: 'en-US' },
+            },
+            required: ['series_id', 'season_number'],
+        },
+    },
+    {
+        name: 'media_tv_episode',
+        description: 'Get TMDB single episode details.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                series_id: { type: 'number' },
+                season_number: { type: 'number' },
+                episode_number: { type: 'number' },
+                language: { type: 'string', default: 'en-US' },
+            },
+            required: ['series_id', 'season_number', 'episode_number'],
+        },
+    },
+    {
+        name: 'media_trending',
+        description: 'Get trending movies or TV.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                media_type: { type: 'string', enum: ['all', 'movie', 'tv'], default: 'all' },
+                time_window: { type: 'string', enum: ['day', 'week'], default: 'week' },
+                language: { type: 'string', default: 'en-US' },
+            },
+            required: ['media_type', 'time_window'],
+        },
+    },
+    {
+        name: 'media_genres',
+        description: 'Get TMDB genre list.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: { type: 'string', enum: ['movie', 'tv'] },
+                language: { type: 'string', default: 'en' },
+            },
+            required: ['type'],
+        },
+    },
+    {
+        name: 'media_languages',
+        description: 'Get TMDB supported languages.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/* ─── Server ─── */
+const server = new Server({ name: 'media-search-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });
+function pickTitle(r) {
+    return r.title ?? r.name;
+}
+function flattenMulti(raw) {
+    const r = raw;
+    return clean({
+        id: r.id,
+        media_type: r.media_type,
+        title: pickTitle(r),
+        year: r.release_date?.slice(0, 4)
+            ?? r.first_air_date?.slice(0, 4),
+        overview: r.overview,
+        poster_url: TmdbClient.img(r.poster_path, 'w500'),
+        backdrop_url: TmdbClient.img(r.backdrop_path, 'w780'),
+        profile_url: TmdbClient.img(r.profile_path, 'w500'),
+        genre_ids: r.genre_ids,
+        popularity: r.popularity,
+        vote_average: r.vote_average,
+        vote_count: r.vote_count,
+        original_language: r.original_language,
+        release_date: r.release_date,
+        first_air_date: r.first_air_date,
+        origin_country: r.origin_country,
+        known_for_department: r.known_for_department,
+    });
+}
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+        let result;
+        switch (name) {
+            case 'media_search': {
+                const a = args;
+                const raw = await client.searchMulti(a.query, a.include_adult, a.language, a.page ?? 1);
+                result = { page: raw.page, total_pages: raw.total_pages, total_results: raw.total_results, results: raw.results.map(flattenMulti) };
+                break;
+            }
+            case 'media_search_movies': {
+                const a = args;
+                const raw = await client.searchMovies(a.query, a.year, a.primary_release_year, a.language, a.page ?? 1);
+                result = { page: raw.page, total_pages: raw.total_pages, total_results: raw.total_results, results: raw.results.map(flattenMulti) };
+                break;
+            }
+            case 'media_search_tv': {
+                const a = args;
+                const raw = await client.searchTv(a.query, a.first_air_date_year, a.language, a.page ?? 1);
+                result = { page: raw.page, total_pages: raw.total_pages, total_results: raw.total_results, results: raw.results.map(flattenMulti) };
+                break;
+            }
+            case 'media_movie_details': {
+                const a = args;
+                const detail = await client.movieDetails(a.movie_id, a.append, a.language);
+                result = clean({
+                    ...detail,
+                    poster_url: TmdbClient.img(detail.poster_path, 'w500'),
+                    backdrop_url: TmdbClient.img(detail.backdrop_path, 'w780'),
+                });
+                break;
+            }
+            case 'media_tv_details': {
+                const a = args;
+                const detail = await client.tvDetails(a.series_id, a.append, a.language);
+                result = clean({
+                    ...detail,
+                    poster_url: TmdbClient.img(detail.poster_path, 'w500'),
+                    backdrop_url: TmdbClient.img(detail.backdrop_path, 'w780'),
+                    seasons: detail.seasons?.map(s => ({
+                        ...s,
+                        poster_url: TmdbClient.img(s.poster_path, 'w342'),
+                    })),
+                });
+                break;
+            }
+            case 'media_tv_season': {
+                const a = args;
+                const detail = await client.tvSeason(a.series_id, a.season_number, a.language);
+                result = clean({
+                    ...detail,
+                    poster_url: TmdbClient.img(detail.poster_path, 'w342'),
+                    episodes: detail.episodes?.map(e => ({
+                        ...e,
+                        still_url: TmdbClient.img(e.still_path, 'w300'),
+                    })),
+                });
+                break;
+            }
+            case 'media_tv_episode': {
+                const a = args;
+                const detail = await client.tvEpisode(a.series_id, a.season_number, a.episode_number, a.language);
+                result = clean({
+                    ...detail,
+                    still_url: TmdbClient.img(detail.still_path, 'w300'),
+                });
+                break;
+            }
+            case 'media_trending': {
+                const a = args;
+                const raw = await client.trending(a.media_type, a.time_window, a.language ?? 'en-US');
+                result = { page: raw.page, total_pages: raw.total_pages, total_results: raw.total_results, results: raw.results.map(flattenMulti) };
+                break;
+            }
+            case 'media_genres': {
+                const a = args;
+                result = await client.genres(a.type, a.language ?? 'en');
+                break;
+            }
+            case 'media_languages': {
+                result = await client.languages();
+                break;
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: msg }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Media Search MCP v3.0.0 (TMDB) ready');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tmdb.d.ts

@@ -0,0 +1,186 @@
+/**
+ * TMDB v3 API client
+ */
+export interface TmdbSearchResult<T = unknown> {
+    page: number;
+    results: T[];
+    total_results: number;
+    total_pages: number;
+}
+export interface TmdbMultiResult {
+    id: number;
+    media_type: 'movie' | 'tv' | 'person';
+    title?: string;
+    name?: string;
+    original_title?: string;
+    original_name?: string;
+    overview?: string;
+    poster_path?: string | null;
+    backdrop_path?: string | null;
+    profile_path?: string | null;
+    genre_ids?: number[];
+    popularity: number;
+    adult: boolean;
+    release_date?: string;
+    first_air_date?: string;
+    origin_country?: string[];
+    original_language?: string;
+    known_for_department?: string;
+    vote_average?: number;
+    vote_count?: number;
+    video?: boolean;
+}
+export interface TmdbMovieDetails {
+    id: number;
+    title: string;
+    original_title: string;
+    overview: string;
+    tagline?: string;
+    status?: string;
+    release_date?: string;
+    runtime?: number;
+    budget?: number;
+    revenue?: number;
+    adult: boolean;
+    imdb_id?: string | null;
+    homepage?: string | null;
+    poster_path?: string | null;
+    backdrop_path?: string | null;
+    vote_average: number;
+    vote_count: number;
+    popularity: number;
+    genres?: Array<{
+        id: number;
+        name: string;
+    }>;
+    production_companies?: Array<{
+        id: number;
+        name: string;
+        logo_path?: string | null;
+        origin_country?: string;
+    }>;
+    production_countries?: Array<{
+        iso_3166_1: string;
+        name: string;
+    }>;
+    spoken_languages?: Array<{
+        iso_639_1: string;
+        name: string;
+        english_name?: string;
+    }>;
+    belongs_to_collection?: {
+        id: number;
+        name: string;
+        poster_path?: string | null;
+        backdrop_path?: string | null;
+    } | null;
+}
+export interface TmdbTvDetails {
+    id: number;
+    name: string;
+    original_name: string;
+    overview: string;
+    tagline?: string;
+    status?: string;
+    type?: string;
+    first_air_date?: string;
+    last_air_date?: string | null;
+    in_production?: boolean;
+    number_of_episodes?: number;
+    number_of_seasons?: number;
+    episode_run_time?: number[];
+    poster_path?: string | null;
+    backdrop_path?: string | null;
+    vote_average: number;
+    vote_count: number;
+    popularity: number;
+    genres?: Array<{
+        id: number;
+        name: string;
+    }>;
+    networks?: Array<{
+        id: number;
+        name: string;
+        logo_path?: string | null;
+        origin_country?: string;
+    }>;
+    origin_country?: string[];
+    original_language?: string;
+    created_by?: Array<{
+        id: number;
+        name: string;
+        profile_path?: string | null;
+    }>;
+    seasons?: Array<{
+        id: number;
+        name: string;
+        overview?: string;
+        season_number: number;
+        episode_count?: number;
+        air_date?: string | null;
+        poster_path?: string | null;
+    }>;
+}
+export interface TmdbSeasonDetails {
+    _id?: string;
+    id: number;
+    name: string;
+    overview?: string;
+    season_number: number;
+    air_date?: string | null;
+    poster_path?: string | null;
+    episodes?: Array<{
+        id: number;
+        name: string;
+        overview?: string;
+        episode_number: number;
+        season_number: number;
+        air_date?: string | null;
+        still_path?: string | null;
+        runtime?: number;
+        vote_average?: number;
+        vote_count?: number;
+    }>;
+}
+export interface TmdbEpisodeDetails {
+    id: number;
+    name: string;
+    overview?: string;
+    air_date?: string | null;
+    episode_number: number;
+    season_number: number;
+    still_path?: string | null;
+    runtime?: number;
+    vote_average?: number;
+    vote_count?: number;
+}
+export interface TmdbGenreList {
+    genres: Array<{
+        id: number;
+        name: string;
+    }>;
+}
+export interface TmdbLanguage {
+    iso_639_1: string;
+    english_name: string;
+    name: string;
+}
+export type TmdbTrendingMedia = 'all' | 'movie' | 'tv';
+export type TmdbTimeWindow = 'day' | 'week';
+export declare class TmdbClient {
+    private apiKey;
+    constructor(apiKey: string);
+    private fetchJson;
+    searchMulti(q: string, adult?: boolean, lang?: string, page?: number): Promise<TmdbSearchResult<TmdbMultiResult>>;
+    searchMovies(q: string, year?: number, primary_release_year?: number, lang?: string, page?: number): Promise<TmdbSearchResult<TmdbMultiResult>>;
+    searchTv(q: string, first_air_date_year?: number, lang?: string, page?: number): Promise<TmdbSearchResult<TmdbMultiResult>>;
+    movieDetails(id: number, append?: string, lang?: string): Promise<TmdbMovieDetails>;
+    tvDetails(id: number, append?: string, lang?: string): Promise<TmdbTvDetails>;
+    tvSeason(seriesId: number, seasonNumber: number, lang?: string): Promise<TmdbSeasonDetails>;
+    tvEpisode(seriesId: number, seasonNumber: number, episodeNumber: number, lang?: string): Promise<TmdbEpisodeDetails>;
+    trending(media: TmdbTrendingMedia, timeWindow: TmdbTimeWindow, lang?: string): Promise<TmdbSearchResult<TmdbMultiResult>>;
+    genres(type: 'movie' | 'tv', lang?: string): Promise<TmdbGenreList>;
+    languages(): Promise<TmdbLanguage[]>;
+    static img(path: string | null | undefined, size?: string): string | undefined;
+}
+//# sourceMappingURL=tmdb.d.ts.map

package/dist/tmdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmdb.d.ts","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"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"}

package/dist/tmdb.js

@@ -0,0 +1,75 @@
+/**
+ * TMDB v3 API client
+ */
+const TMDB_BASE = 'https://api.themoviedb.org/3';
+const IMG_BASE = 'https://image.tmdb.org/t/p';
+function buildImgUrl(path, size = 'w500') {
+    return path ? `${IMG_BASE}/${size}${path}` : undefined;
+}
+export class TmdbClient {
+    apiKey;
+    constructor(apiKey) {
+        if (!apiKey)
+            throw new Error('TMDB API key is required. Set TMDB_API_KEY env var.');
+        this.apiKey = apiKey;
+    }
+    async fetchJson(path) {
+        const url = new URL(TMDB_BASE + path);
+        url.searchParams.set('api_key', this.apiKey);
+        const res = await fetch(url.toString());
+        if (!res.ok) {
+            const txt = await res.text().catch(() => 'TMDB error');
+            throw new Error(`TMDB ${res.status}: ${txt}`);
+        }
+        return res.json();
+    }
+    searchMulti(q, adult = false, lang = 'en-US', page = 1) {
+        return this.fetchJson(`/search/multi?query=${enc(q)}&include_adult=${adult}&language=${enc(lang)}&page=${page}`);
+    }
+    searchMovies(q, year, primary_release_year, lang = 'en-US', page = 1) {
+        let p = `/search/movie?query=${enc(q)}&language=${enc(lang)}&page=${page}`;
+        if (year !== undefined)
+            p += `&year=${year}`;
+        if (primary_release_year !== undefined)
+            p += `&primary_release_year=${primary_release_year}`;
+        return this.fetchJson(p);
+    }
+    searchTv(q, first_air_date_year, lang = 'en-US', page = 1) {
+        let p = `/search/tv?query=${enc(q)}&language=${enc(lang)}&page=${page}`;
+        if (first_air_date_year !== undefined)
+            p += `&first_air_date_year=${first_air_date_year}`;
+        return this.fetchJson(p);
+    }
+    movieDetails(id, append, lang = 'en-US') {
+        let p = `/movie/${id}?language=${enc(lang)}`;
+        if (append)
+            p += `&append_to_response=${enc(append)}`;
+        return this.fetchJson(p);
+    }
+    tvDetails(id, append, lang = 'en-US') {
+        let p = `/tv/${id}?language=${enc(lang)}`;
+        if (append)
+            p += `&append_to_response=${enc(append)}`;
+        return this.fetchJson(p);
+    }
+    tvSeason(seriesId, seasonNumber, lang = 'en-US') {
+        return this.fetchJson(`/tv/${seriesId}/season/${seasonNumber}?language=${enc(lang)}`);
+    }
+    tvEpisode(seriesId, seasonNumber, episodeNumber, lang = 'en-US') {
+        return this.fetchJson(`/tv/${seriesId}/season/${seasonNumber}/episode/${episodeNumber}?language=${enc(lang)}`);
+    }
+    trending(media, timeWindow, lang = 'en-US') {
+        return this.fetchJson(`/trending/${media}/${timeWindow}?language=${enc(lang)}`);
+    }
+    genres(type, lang = 'en') {
+        return this.fetchJson(`/genre/${type}/list?language=${enc(lang)}`);
+    }
+    languages() {
+        return this.fetchJson('/configuration/languages');
+    }
+    static img(path, size = 'w500') {
+        return buildImgUrl(path, size);
+    }
+}
+function enc(v) { return encodeURIComponent(v); }
+//# sourceMappingURL=tmdb.js.map

package/dist/tmdb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmdb.js","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@broville/media-search-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for movie and TV show search via TMDB API (v3)",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/inject-shebang.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tmdb",
+    "movies",
+    "tv-shows",
+    "search"
+  ],
+  "author": "Broville <neo@eaglepass.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Broville/media_search_mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Broville/media_search_mcp/issues"
+  },
+  "homepage": "https://github.com/Broville/media_search_mcp#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}