@cyanheads/anime-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/anime-get-rankings.tool.js

@@ -0,0 +1,154 @@
+/**
+ * @fileoverview anime_get_rankings tool — top, trending, or seasonal rankings.
+ * @module mcp-server/tools/definitions/anime-get-rankings.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import * as anilist from '../../../services/anilist/anilist-service.js';
+const SeasonEnum = z
+    .enum(['WINTER', 'SPRING', 'SUMMER', 'FALL'])
+    .describe('Anime broadcast season. WINTER=Jan–Mar, SPRING=Apr–Jun, SUMMER=Jul–Sep, FALL=Oct–Dec.');
+const FormatEnum = z
+    .enum(['TV', 'TV_SHORT', 'MOVIE', 'SPECIAL', 'OVA', 'ONA', 'MUSIC', 'MANGA', 'NOVEL', 'ONE_SHOT'])
+    .describe('Publication/broadcast format filter.');
+export const animeGetRankings = tool('anime_get_rankings', {
+    description: 'Top, trending, or seasonal rankings. Filterable by genre, tag, and format. ' +
+        '"top" returns all-time by score; "trending" returns current week; ' +
+        '"seasonal" returns the current or specified season sorted by popularity.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        mode: z
+            .enum(['top', 'trending', 'seasonal'])
+            .describe('"top": highest-scoring of all time. ' +
+            '"trending": most active this week. ' +
+            '"seasonal": most popular in the current or specified season/year.'),
+        media_type: z.enum(['ANIME', 'MANGA']).describe('Media type to rank.'),
+        format: FormatEnum.optional(),
+        genre: z.string().max(100).optional().describe('Genre filter, e.g. "Action", "Romance".'),
+        season: SeasonEnum.optional().describe('Season for "seasonal" mode. Defaults to current season.'),
+        season_year: z
+            .number()
+            .int()
+            .min(1940)
+            .max(2100)
+            .optional()
+            .describe('Year for "seasonal" mode. Defaults to current year.'),
+        page: z.number().int().min(1).default(1).describe('1-based page number.'),
+        per_page: z.number().int().min(1).max(50).default(25).describe('Results per page. Maximum 50.'),
+        include_adult: z
+            .boolean()
+            .default(false)
+            .describe('Include adult/NSFW content. Default false.'),
+    }),
+    output: z.object({
+        mode: z.enum(['top', 'trending', 'seasonal']).describe('Ranking mode used.'),
+        media_type: z.enum(['ANIME', 'MANGA']).describe('Media type ranked.'),
+        season_label: z
+            .string()
+            .nullable()
+            .describe('Season label for seasonal mode, e.g. "FALL 2024", or null.'),
+        page: z.number().int().describe('Current page number.'),
+        has_next_page: z.boolean().describe('Whether more pages are available.'),
+        total_results: z.number().int().nullable().describe('Total matching results, or null.'),
+        entries: z
+            .array(z
+            .object({
+            rank: z.number().int().describe('1-based rank position on this page.'),
+            id: z.number().int().describe('AniList media ID.'),
+            id_mal: z.number().int().nullable().describe('MyAnimeList ID, or null.'),
+            title: z.string().nullable().describe('Romanized title.'),
+            title_english: z.string().nullable().describe('English title, or null.'),
+            type: z.enum(['ANIME', 'MANGA']).describe('Media type.'),
+            format: z.string().nullable().describe('Format: TV, MOVIE, OVA, etc.'),
+            status: z.string().nullable().describe('Production status.'),
+            season: z.string().nullable().describe('Broadcast season label, or null.'),
+            episodes: z.number().int().nullable().describe('Episode count, or null.'),
+            chapters: z.number().int().nullable().describe('Chapter count, or null.'),
+            mean_score: z.number().nullable().describe('AniList mean score 0–100, or null.'),
+            is_adult: z.boolean().describe('Whether marked adult/NSFW.'),
+            cover_image_url: z.string().nullable().describe('Cover image URL, or null.'),
+        })
+            .describe('A ranked media entry.'))
+            .describe('Ranked entries.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Fetching rankings', { mode: input.mode, mediaType: input.media_type });
+        const page = await anilist.getRankings({
+            mediaType: input.media_type,
+            mode: input.mode,
+            format: input.format,
+            genre: input.genre,
+            season: input.season,
+            seasonYear: input.season_year,
+            page: input.page,
+            perPage: input.per_page,
+            includeAdult: input.include_adult,
+        });
+        // Compute season label for seasonal mode
+        let seasonLabel = null;
+        if (input.mode === 'seasonal') {
+            if (input.season && input.season_year) {
+                seasonLabel = `${input.season} ${input.season_year}`;
+            }
+            else {
+                // Auto-computed in service
+                const now = new Date();
+                const month = now.getMonth() + 1;
+                const year = now.getFullYear();
+                const season = month <= 3 ? 'WINTER' : month <= 6 ? 'SPRING' : month <= 9 ? 'SUMMER' : 'FALL';
+                seasonLabel = `${season} ${year}`;
+            }
+        }
+        const startRank = (input.page - 1) * input.per_page + 1;
+        return {
+            mode: input.mode,
+            media_type: input.media_type,
+            season_label: seasonLabel,
+            page: page.pageInfo.currentPage,
+            has_next_page: page.pageInfo.hasNextPage,
+            total_results: page.pageInfo.total ?? null,
+            entries: page.media.map((m, idx) => ({
+                rank: startRank + idx,
+                id: m.id,
+                id_mal: m.idMal ?? null,
+                title: m.title.romaji,
+                title_english: m.title.english,
+                type: m.type,
+                format: m.format ?? null,
+                status: m.status ?? null,
+                season: m.season && m.seasonYear ? `${m.season} ${m.seasonYear}` : (m.season ?? null),
+                episodes: m.episodes ?? null,
+                chapters: m.chapters ?? null,
+                mean_score: m.meanScore ?? null,
+                is_adult: m.isAdult,
+                cover_image_url: m.coverImage?.large ?? null,
+            })),
+        };
+    },
+    format: (result) => {
+        const modeLabel = result.mode === 'top'
+            ? `All-Time Top ${result.media_type}`
+            : result.mode === 'trending'
+                ? `Trending ${result.media_type}`
+                : `${result.season_label ?? 'Current Season'} ${result.media_type}`;
+        const lines = [
+            `## ${modeLabel}`,
+            `mode: ${result.mode} | season_label: ${result.season_label ?? 'none'}`,
+            `Page ${result.page}${result.total_results !== null ? ` · ${result.total_results} total` : ''}`,
+            '',
+        ];
+        for (const entry of result.entries) {
+            const title = entry.title_english ?? entry.title ?? 'Unknown';
+            const score = entry.mean_score !== null ? ` · ${entry.mean_score}/100` : '';
+            const fmt = entry.format ? ` · ${entry.format}` : '';
+            const ep = entry.episodes !== null ? ` · ${entry.episodes} eps` : '';
+            const chap = entry.chapters !== null ? ` chapters:${entry.chapters}` : '';
+            const adult = entry.is_adult ? ' · [Adult]' : '';
+            lines.push(`${entry.rank}. **${title}** (${entry.title ?? '?'}) [AL:${entry.id}${entry.id_mal !== null ? `/MAL:${entry.id_mal}` : ''}]${fmt}${score}${ep}${chap}${adult}`, `   status: ${entry.status ?? 'N/A'} | season: ${entry.season ?? 'N/A'} | cover: ${entry.cover_image_url ?? 'none'}`);
+        }
+        if (result.has_next_page) {
+            lines.push('', `_More results available (page ${result.page + 1})._`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=anime-get-rankings.tool.js.map

package/dist/mcp-server/tools/definitions/anime-get-rankings.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anime-get-rankings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/anime-get-rankings.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/anime-get-recommendations.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview anime_get_recommendations tool — merged recommendations from AniList and Jikan.
+ * @module mcp-server/tools/definitions/anime-get-recommendations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const animeGetRecommendations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodNumber;
+    liked_aspects: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    source_id: z.ZodNumber;
+    source_id_mal: z.ZodNullable<z.ZodNumber>;
+    source_type: z.ZodNullable<z.ZodString>;
+    liked_aspects: z.ZodNullable<z.ZodString>;
+    has_next_page: z.ZodBoolean;
+    recommendations: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        id_mal: z.ZodNullable<z.ZodNumber>;
+        title: z.ZodNullable<z.ZodString>;
+        title_english: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodString>;
+        format: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+        mean_score: z.ZodNullable<z.ZodNumber>;
+        cover_image_url: z.ZodNullable<z.ZodString>;
+        anilist_rating: z.ZodNullable<z.ZodNumber>;
+        jikan_votes: z.ZodNullable<z.ZodNumber>;
+        sources: z.ZodArray<z.ZodEnum<{
+            anilist: "anilist";
+            jikan: "jikan";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=anime-get-recommendations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/anime-get-recommendations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anime-get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/anime-get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAoMlC,CAAC"}

package/dist/mcp-server/tools/definitions/anime-get-recommendations.tool.js

@@ -0,0 +1,174 @@
+/**
+ * @fileoverview anime_get_recommendations tool — merged recommendations from AniList and Jikan.
+ * @module mcp-server/tools/definitions/anime-get-recommendations.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import * as anilist from '../../../services/anilist/anilist-service.js';
+import * as jikan from '../../../services/jikan/jikan-service.js';
+export const animeGetRecommendations = tool('anime_get_recommendations', {
+    description: 'Recommendations for a title, merged from AniList and Jikan (MAL), with scores and vote counts. ' +
+        'AniList recommendations use community rating scores; Jikan adds MAL user recommendations with vote counts. ' +
+        'Both sources are surfaced separately — not blended into a composite score.',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        id: z
+            .number()
+            .int()
+            .min(1)
+            .describe('AniList media ID of the title to get recommendations for.'),
+        liked_aspects: z
+            .string()
+            .max(500)
+            .optional()
+            .describe('Optional: what you liked about this title (e.g. "the slow-burn romance" or "mecha action"). ' +
+            'Included in the output for context; the agent can use it to highlight relevant picks.'),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe('1-based page number for AniList recommendations.'),
+        per_page: z
+            .number()
+            .int()
+            .min(1)
+            .max(25)
+            .default(25)
+            .describe('Recommendations per page from AniList. Maximum 25.'),
+    }),
+    output: z.object({
+        source_id: z.number().int().describe('AniList ID of the source title.'),
+        source_id_mal: z.number().int().nullable().describe('MAL ID of the source title, or null.'),
+        source_type: z.string().nullable().describe('Source media type: ANIME or MANGA.'),
+        liked_aspects: z.string().nullable().describe('Liked aspects provided by the caller, or null.'),
+        has_next_page: z.boolean().describe('Whether more AniList recommendations are available.'),
+        recommendations: z
+            .array(z
+            .object({
+            id: z.number().int().describe('AniList media ID of the recommended title.'),
+            id_mal: z
+                .number()
+                .int()
+                .nullable()
+                .describe('MAL ID of the recommended title, or null.'),
+            title: z.string().nullable().describe('Romanized title.'),
+            title_english: z.string().nullable().describe('English title, or null.'),
+            type: z.string().nullable().describe('Media type.'),
+            format: z.string().nullable().describe('Format: TV, MOVIE, OVA, etc.'),
+            status: z.string().nullable().describe('Production status.'),
+            mean_score: z.number().nullable().describe('AniList mean score 0–100, or null.'),
+            cover_image_url: z.string().nullable().describe('Cover image URL, or null.'),
+            anilist_rating: z
+                .number()
+                .int()
+                .nullable()
+                .describe('AniList community recommendation rating. Higher = more recommended.'),
+            jikan_votes: z
+                .number()
+                .int()
+                .nullable()
+                .describe('MAL user recommendation vote count, or null when not in Jikan results.'),
+            sources: z
+                .array(z
+                .enum(['anilist', 'jikan'])
+                .describe('A source that includes this recommendation.'))
+                .describe('Which sources include this recommendation.'),
+        })
+            .describe('A recommendation entry.'))
+            .describe('Merged recommendations, sorted by AniList rating descending. ' +
+            'Items appear once even if both sources recommend them; sources array lists all contributors.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Fetching recommendations', { id: input.id });
+        // Get AniList recs — also fetches idMal for Jikan fan-out
+        const anilistRecs = await anilist.getRecommendations({
+            mediaId: input.id,
+            page: input.page,
+            perPage: input.per_page,
+        });
+        // Need media detail for idMal and type
+        const mediaDetail = await anilist.getMediaById(input.id);
+        const idMal = mediaDetail?.idMal ?? null;
+        const mediaType = mediaDetail?.type ?? 'ANIME';
+        // Fetch Jikan recs (supplement — degrades gracefully)
+        let jikanRecs = [];
+        if (idMal) {
+            try {
+                jikanRecs = await jikan.getRecommendations(idMal, mediaType);
+            }
+            catch (err) {
+                ctx.log.warning('Jikan recommendations failed', { error: String(err) });
+            }
+        }
+        // Build Jikan vote map keyed by MAL ID
+        const jikanVoteMap = new Map();
+        for (const rec of jikanRecs) {
+            jikanVoteMap.set(rec.entry.mal_id, rec.votes);
+        }
+        // Merge: AniList records are primary, supplement with Jikan votes
+        const merged = anilistRecs.nodes
+            .filter((n) => n.mediaRecommendation !== null)
+            .map((n) => {
+            const m = n.mediaRecommendation;
+            const jikanVotes = m.idMal ? (jikanVoteMap.get(m.idMal) ?? null) : null;
+            // Remove from Jikan map so we know what's left (Jikan-only recs)
+            if (m.idMal)
+                jikanVoteMap.delete(m.idMal);
+            const sources = ['anilist'];
+            if (jikanVotes !== null)
+                sources.push('jikan');
+            return {
+                id: m.id,
+                id_mal: m.idMal ?? null,
+                title: m.title.romaji,
+                title_english: m.title.english,
+                type: m.type ?? null,
+                format: m.format ?? null,
+                status: m.status ?? null,
+                mean_score: m.meanScore ?? null,
+                cover_image_url: m.coverImage?.large ?? null,
+                anilist_rating: n.rating ?? null,
+                jikan_votes: jikanVotes,
+                sources,
+            };
+        });
+        // Sort by AniList rating descending
+        merged.sort((a, b) => (b.anilist_rating ?? 0) - (a.anilist_rating ?? 0));
+        return {
+            source_id: input.id,
+            source_id_mal: idMal,
+            source_type: mediaType,
+            liked_aspects: input.liked_aspects ?? null,
+            has_next_page: anilistRecs.hasNextPage,
+            recommendations: merged,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Recommendations for AL:${result.source_id}${result.source_id_mal ? ` / MAL:${result.source_id_mal}` : ''}`,
+            `source_type: ${result.source_type ?? 'N/A'}`,
+        ];
+        if (result.liked_aspects) {
+            lines.push(`_Based on liking: "${result.liked_aspects}"_`);
+        }
+        lines.push('');
+        if (result.recommendations.length === 0) {
+            lines.push('No recommendations found.');
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        for (const rec of result.recommendations) {
+            const title = rec.title_english ?? rec.title ?? 'Unknown';
+            const score = rec.mean_score !== null ? ` · ${rec.mean_score}/100` : '';
+            const fmt = rec.format ? ` · ${rec.format}` : '';
+            const alRating = rec.anilist_rating !== null ? ` · AL rating: ${rec.anilist_rating}` : '';
+            const jVotes = rec.jikan_votes !== null ? ` · MAL votes: ${rec.jikan_votes}` : '';
+            const sources = rec.sources.join('+');
+            lines.push(`**${title}** (${rec.title ?? '?'}) [AL:${rec.id}${rec.id_mal !== null ? `/MAL:${rec.id_mal}` : ''}] type:${rec.type ?? 'N/A'}${fmt}${score}${alRating}${jVotes} _(${sources})_`, `  status: ${rec.status ?? 'N/A'} | cover: ${rec.cover_image_url ?? 'none'}`);
+        }
+        if (result.has_next_page) {
+            lines.push('', `_More recommendations available (page ${result.recommendations.length > 0 ? 'next' : '1'})._`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=anime-get-recommendations.tool.js.map

package/dist/mcp-server/tools/definitions/anime-get-recommendations.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anime-get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/anime-get-recommendations.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/anime-get-relations.tool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview anime_get_relations tool — franchise watch/read order via multi-hop relation graph traversal.
+ * BFS over AniList relation edges up to max_depth, then topological sort for recommended order.
+ * @module mcp-server/tools/definitions/anime-get-relations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const animeGetRelations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodNumber;
+    max_depth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    root_id: z.ZodNumber;
+    total_entries: z.ZodNumber;
+    depth_reached: z.ZodNumber;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        id_mal: z.ZodNullable<z.ZodNumber>;
+        title: z.ZodNullable<z.ZodString>;
+        title_english: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodString>;
+        format: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+        season: z.ZodNullable<z.ZodString>;
+        season_year: z.ZodNullable<z.ZodNumber>;
+        episodes: z.ZodNullable<z.ZodNumber>;
+        chapters: z.ZodNullable<z.ZodNumber>;
+        mean_score: z.ZodNullable<z.ZodNumber>;
+        is_adult: z.ZodBoolean;
+        cover_image_url: z.ZodNullable<z.ZodString>;
+        relation_to_root: z.ZodNullable<z.ZodString>;
+        watch_order_category: z.ZodEnum<{
+            main: "main";
+            supplementary: "supplementary";
+        }>;
+        is_root: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Root media ID not found on AniList";
+    readonly recovery: "Use anime_search_media to find a valid AniList ID and retry.";
+}], undefined>;
+//# sourceMappingURL=anime-get-relations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/anime-get-relations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anime-get-relations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/anime-get-relations.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAgCjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwP5B,CAAC"}