get_popular_shows
Retrieve popular TV shows with simple pagination for easy navigation and discovery of trending content.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_popular_shows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码,默认为1 |
Implementation Reference
- src/tools/popularTrendingTool.ts:58-83 (handler)The core handler function that fetches popular TV shows using tmdbClient.getPopularTvShows, maps and formats the results into ShowsListResponse, and handles errors.
export async function getPopularShows(params: GetPopularShowsParams = {}): Promise<ShowsListResponse> { const { page = 1 } = params; try { const response = await tmdbClient.getPopularTvShows(page); // 格式化结果 const result: ShowsListResponse = { page: response.page, results: response.results.map((show: any) => ({ id: show.id, name: show.name, overview: show.overview || '暂无简介', poster_path: show.poster_path, vote_average: show.vote_average || 0, first_air_date: show.first_air_date })), total_pages: response.total_pages, total_results: response.total_results }; return result; } catch (error) { throw new Error(`获取热门剧集失败: ${error instanceof Error ? error.message : String(error)}`); } } - src/server.ts:174-185 (registration)Registers the 'get_popular_shows' tool on the MCP server with Zod schema for 'page' parameter and handler that calls getPopularShows.
server.tool("get_popular_shows", { page: z.number().optional().default(1).describe('页码,默认为1') }, async (params) => { console.log(`收到获取热门剧集请求,页码: ${params.page || 1}`); const results = await getPopularShows(params); return { content: [{ type: "text", text: JSON.stringify(results) }] }; } ); - src/tools/popularTrendingTool.ts:6-9 (schema)TypeScript interface defining the input parameters for the getPopularShows function.
export interface GetPopularShowsParams { /** 页码,默认为1 */ page?: number; } - TypeScript interface defining the output response structure for the getPopularShows function.
export interface ShowsListResponse { /** 当前页码 */ page: number; /** 剧集列表 */ results: ShowInfo[]; /** 总页数 */ total_pages?: number; /** 总结果数 */ total_results?: number; } - src/tools/index.ts:58-65 (registration)Re-exports the getPopularShows function and types from popularTrendingTool.ts for use in other modules like server.ts.
export { getPopularShows, getTrendingShows, type GetPopularShowsParams, type GetTrendingShowsParams, type ShowsListResponse, type ShowInfo } from './popularTrendingTool';