@rahmandayub/pexels-mcp 0.0.0-stage → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +192 -2
  3. package/dist/cache.js +77 -0
  4. package/dist/cache.js.map +1 -0
  5. package/dist/config.js +127 -0
  6. package/dist/config.js.map +1 -0
  7. package/dist/errors.js +57 -0
  8. package/dist/errors.js.map +1 -0
  9. package/dist/index.js +77 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/log.js +54 -0
  12. package/dist/log.js.map +1 -0
  13. package/dist/pexels/client.js +193 -0
  14. package/dist/pexels/client.js.map +1 -0
  15. package/dist/pexels/quirks.js +283 -0
  16. package/dist/pexels/quirks.js.map +1 -0
  17. package/dist/pexels/schemas.js +134 -0
  18. package/dist/pexels/schemas.js.map +1 -0
  19. package/dist/present/collection.js +23 -0
  20. package/dist/present/collection.js.map +1 -0
  21. package/dist/present/envelope.js +20 -0
  22. package/dist/present/envelope.js.map +1 -0
  23. package/dist/present/photo.js +86 -0
  24. package/dist/present/photo.js.map +1 -0
  25. package/dist/present/util.js +24 -0
  26. package/dist/present/util.js.map +1 -0
  27. package/dist/present/video.js +117 -0
  28. package/dist/present/video.js.map +1 -0
  29. package/dist/tools/collection-media.js +54 -0
  30. package/dist/tools/collection-media.js.map +1 -0
  31. package/dist/tools/curated-photos.js +42 -0
  32. package/dist/tools/curated-photos.js.map +1 -0
  33. package/dist/tools/featured-collections.js +42 -0
  34. package/dist/tools/featured-collections.js.map +1 -0
  35. package/dist/tools/get-photo.js +46 -0
  36. package/dist/tools/get-photo.js.map +1 -0
  37. package/dist/tools/get-video.js +46 -0
  38. package/dist/tools/get-video.js.map +1 -0
  39. package/dist/tools/helpers.js +38 -0
  40. package/dist/tools/helpers.js.map +1 -0
  41. package/dist/tools/index.js +21 -0
  42. package/dist/tools/index.js.map +1 -0
  43. package/dist/tools/photo-url.js +84 -0
  44. package/dist/tools/photo-url.js.map +1 -0
  45. package/dist/tools/popular-videos.js +62 -0
  46. package/dist/tools/popular-videos.js.map +1 -0
  47. package/dist/tools/preview.js +21 -0
  48. package/dist/tools/preview.js.map +1 -0
  49. package/dist/tools/search-photos.js +67 -0
  50. package/dist/tools/search-photos.js.map +1 -0
  51. package/dist/tools/search-videos.js +60 -0
  52. package/dist/tools/search-videos.js.map +1 -0
  53. package/dist/types.js +118 -0
  54. package/dist/types.js.map +1 -0
  55. package/dist/version.js +6 -0
  56. package/dist/version.js.map +1 -0
  57. package/package.json +52 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK1D,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,GAAgB;IAC/D,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC"}
@@ -0,0 +1,84 @@
1
+ import { z } from 'zod';
2
+ import { presentPhoto } from '../present/photo.js';
3
+ import { asUrl } from '../present/util.js';
4
+ import { ToolError } from '../errors.js';
5
+ import { deriveImageUrl, photoByIdPath } from '../pexels/quirks.js';
6
+ import { ApiPhoto } from '../pexels/schemas.js';
7
+ import { PhotoUrlOut } from '../types.js';
8
+ import { READ_ONLY_ANNOTATIONS, runTool } from './helpers.js';
9
+ const MAX_DIMENSION = 5_000;
10
+ const side = (label) => z
11
+ .number()
12
+ .int(`${label} must be a whole number`)
13
+ .min(16, `${label} must be at least 16 pixels`)
14
+ .max(MAX_DIMENSION, `${label} must be at most ${MAX_DIMENSION} pixels`)
15
+ .optional();
16
+ export const photoUrlInput = z
17
+ .object({
18
+ id: z.number().int('id must be a whole number').positive('id must be a positive integer'),
19
+ width: side('width').describe('Target width in pixels'),
20
+ height: side('height').describe('Target height in pixels'),
21
+ fit: z
22
+ .enum(['crop', 'max'], {
23
+ message: 'fit must be "crop" (exact box) or "max" (stay inside the box)',
24
+ })
25
+ .optional()
26
+ .describe('crop = exact box, max = keep the ratio inside the box; defaults to crop when both sides are given'),
27
+ })
28
+ .refine((value) => value.width !== undefined || value.height !== undefined, {
29
+ message: 'give width, height, or both — an empty box has no URL to derive',
30
+ path: ['width'],
31
+ })
32
+ .refine((value) => value.fit !== 'crop' || (value.width !== undefined && value.height !== undefined), {
33
+ message: 'fit="crop" needs both width and height; give only one side to keep the ratio',
34
+ path: ['fit'],
35
+ });
36
+ export function registerPhotoUrl(server, ctx) {
37
+ server.registerTool('photo_url', {
38
+ title: 'Derive a photo URL',
39
+ description: 'Get a resized or exact-cropped photo URL, e.g. a 1600x900 hero. Derives it from the CDN URL Pexels already returned, so it needs one cached lookup and no image download.',
40
+ inputSchema: photoUrlInput,
41
+ outputSchema: PhotoUrlOut,
42
+ annotations: READ_ONLY_ANNOTATIONS,
43
+ }, async (args) => runTool('photo_url', async () => {
44
+ const { value, cacheHit } = await ctx.client.get(photoByIdPath(args.id), {}, ApiPhoto);
45
+ const photo = presentPhoto(value, 'brief');
46
+ const original = asUrl(value.src.original ?? value.src.large, photo.page_url);
47
+ const url = deriveImageUrl(original, {
48
+ width: args.width,
49
+ height: args.height,
50
+ fit: args.fit,
51
+ });
52
+ if (url === null) {
53
+ throw new ToolError('DECODE', `Pexels did not return a usable original image URL for photo ${args.id}`, {
54
+ hint: 'retry — if it persists, the payload shape changed',
55
+ });
56
+ }
57
+ const box = [args.width ?? 'auto', args.height ?? 'auto'].join('x');
58
+ const text = [
59
+ `${args.id} → ${box}${args.fit ? ` ${args.fit}` : ''}`,
60
+ `url: ${url}`,
61
+ `source: ${photo.width}x${photo.height}`,
62
+ `page: ${photo.page_url}`,
63
+ ].join('\n');
64
+ return {
65
+ text,
66
+ structured: {
67
+ id: args.id,
68
+ url,
69
+ width: args.width ?? null,
70
+ height: args.height ?? null,
71
+ fit: args.fit ?? (args.width !== undefined && args.height !== undefined ? 'crop' : null),
72
+ source: {
73
+ page_url: photo.page_url,
74
+ original_url: original,
75
+ width: photo.width,
76
+ height: photo.height,
77
+ },
78
+ },
79
+ count: 1,
80
+ cacheHit,
81
+ };
82
+ }));
83
+ }
84
+ //# sourceMappingURL=photo-url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photo-url.js","sourceRoot":"","sources":["../../src/tools/photo-url.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ import { z } from 'zod';
2
+ import { listFooter, listHeader } from '../present/envelope.js';
3
+ import { joinBlocks } from '../present/util.js';
4
+ import { presentVideo, videoBlock } from '../present/video.js';
5
+ import { derivePagination } from '../pexels/quirks.js';
6
+ import { ApiVideoList } from '../pexels/schemas.js';
7
+ import { Detail, PageInput, PerPageInput, VideoListOut } from '../types.js';
8
+ import { READ_ONLY_ANNOTATIONS, runTool } from './helpers.js';
9
+ const dimension = (label) => z.number().int(`${label} must be a whole number`).min(0, `${label} must be 0 or more`).optional();
10
+ export const popularVideosInput = z
11
+ .object({
12
+ min_width: dimension('min_width').describe('Minimum width in pixels'),
13
+ max_width: dimension('max_width').describe('Maximum width in pixels'),
14
+ min_height: dimension('min_height').describe('Minimum height in pixels'),
15
+ max_height: dimension('max_height').describe('Maximum height in pixels'),
16
+ min_duration: dimension('min_duration').describe('Minimum duration in seconds'),
17
+ max_duration: dimension('max_duration').describe('Maximum duration in seconds'),
18
+ page: PageInput,
19
+ per_page: PerPageInput,
20
+ detail: Detail,
21
+ })
22
+ .refine((value) => value.min_width === undefined || value.max_width === undefined || value.min_width <= value.max_width, { message: 'min_width must not exceed max_width', path: ['min_width'] })
23
+ .refine((value) => value.min_height === undefined || value.max_height === undefined || value.min_height <= value.max_height, { message: 'min_height must not exceed max_height', path: ['min_height'] })
24
+ .refine((value) => value.min_duration === undefined || value.max_duration === undefined || value.min_duration <= value.max_duration, { message: 'min_duration must not exceed max_duration', path: ['min_duration'] });
25
+ export function registerPopularVideos(server, ctx) {
26
+ server.registerTool('popular_videos', {
27
+ title: 'Popular videos',
28
+ description: 'Trending Pexels videos, filterable by width, height and duration in seconds. Useful for "a short 4K clip".',
29
+ inputSchema: popularVideosInput,
30
+ outputSchema: VideoListOut,
31
+ annotations: READ_ONLY_ANNOTATIONS,
32
+ }, async (args) => runTool('popular_videos', async () => {
33
+ const { value, cacheHit } = await ctx.client.get('/videos/popular', {
34
+ min_width: args.min_width,
35
+ max_width: args.max_width,
36
+ min_height: args.min_height,
37
+ max_height: args.max_height,
38
+ min_duration: args.min_duration,
39
+ max_duration: args.max_duration,
40
+ page: args.page,
41
+ per_page: args.per_page,
42
+ }, ApiVideoList);
43
+ const pagination = derivePagination({
44
+ page: args.page,
45
+ per_page: args.per_page,
46
+ count: value.videos.length,
47
+ total_results: value.total_results,
48
+ hasNextHint: Boolean(value.next_page),
49
+ });
50
+ const results = value.videos.map((video) => presentVideo(video, args.detail));
51
+ const text = results.length === 0
52
+ ? 'No popular videos match those filters.\n- widen the width, height or duration ranges\n- try search_videos with a query instead'
53
+ : joinBlocks(listHeader('popular videos', pagination, results.length), results.map((video) => videoBlock(video, args.detail)), listFooter(pagination));
54
+ return {
55
+ text,
56
+ structured: { count: results.length, pagination, results },
57
+ count: results.length,
58
+ cacheHit,
59
+ };
60
+ }));
61
+ }
62
+ //# sourceMappingURL=popular-videos.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"popular-videos.js","sourceRoot":"","sources":["../../src/tools/popular-videos.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { deriveImageUrl } from '../pexels/quirks.js';
2
+ /**
3
+ * Width of the inline preview. Small enough to stay cheap in context (a few
4
+ * hundred tokens) while still letting a model judge composition and colour.
5
+ * Measured: w=800 costs ~57KB, w=480 lands around 20KB.
6
+ */
7
+ export const PREVIEW_WIDTH = 480;
8
+ /**
9
+ * Download one small rendition for an inline preview.
10
+ *
11
+ * Returns null when the source URL is not on the Pexels CDN — the caller keeps
12
+ * its text answer instead of failing the whole call.
13
+ */
14
+ export async function previewImage(client, sourceUrl) {
15
+ const url = deriveImageUrl(sourceUrl, { width: PREVIEW_WIDTH });
16
+ if (url === null)
17
+ return null;
18
+ const image = await client.getImage(url);
19
+ return { data: image.data.toString('base64'), mimeType: image.mimeType };
20
+ }
21
+ //# sourceMappingURL=preview.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/tools/preview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoB,EACpB,SAAiB;IAEjB,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IAChE,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC3E,CAAC"}
@@ -0,0 +1,67 @@
1
+ import { z } from 'zod';
2
+ import { listFooter, listHeader } from '../present/envelope.js';
3
+ import { presentPhoto, photoBlock } from '../present/photo.js';
4
+ import { joinBlocks, truncate } from '../present/util.js';
5
+ import { COLOR_MESSAGE, collapseWhitespace, derivePagination, normaliseColor } from '../pexels/quirks.js';
6
+ import { ApiPhotoList } from '../pexels/schemas.js';
7
+ import { Detail, Orientation, PageInput, PerPageInput, PhotoListOut, Size } from '../types.js';
8
+ import { READ_ONLY_ANNOTATIONS, SEARCH_HINTS, runTool } from './helpers.js';
9
+ export const searchPhotosInput = z.object({
10
+ query: z
11
+ .string()
12
+ .transform(collapseWhitespace)
13
+ .pipe(z
14
+ .string()
15
+ .min(1, 'query must not be empty — describe what to search for')
16
+ .max(200, 'query must be at most 200 characters'))
17
+ .describe('Search terms, e.g. "mountains at sunset"'),
18
+ orientation: Orientation.optional().describe('landscape, portrait, or square'),
19
+ size: Size.optional().describe('Minimum photo size: large = 24MP, medium = 12MP, small = 4MP'),
20
+ color: z
21
+ .string()
22
+ .refine((value) => normaliseColor(value) !== null, COLOR_MESSAGE)
23
+ .transform((value) => normaliseColor(value) ?? value)
24
+ .optional()
25
+ .describe('#rrggbb, #rgb, or a named colour such as "blue"'),
26
+ locale: z.string().optional().describe('Locale such as en-US or es-ES'),
27
+ page: PageInput,
28
+ per_page: PerPageInput,
29
+ detail: Detail,
30
+ });
31
+ export function registerSearchPhotos(server, ctx) {
32
+ server.registerTool('search_photos', {
33
+ title: 'Search photos',
34
+ description: 'Search Pexels stock photos. Returns compact results by default: id, dimensions, aspect ratio, attribution and ready-to-use preview/download URLs.',
35
+ inputSchema: searchPhotosInput,
36
+ outputSchema: PhotoListOut,
37
+ annotations: READ_ONLY_ANNOTATIONS,
38
+ }, async (args) => runTool('search_photos', async () => {
39
+ const { value, cacheHit } = await ctx.client.get('/v1/search', {
40
+ query: args.query,
41
+ orientation: args.orientation,
42
+ size: args.size,
43
+ color: args.color,
44
+ locale: args.locale ?? ctx.config.locale,
45
+ page: args.page,
46
+ per_page: args.per_page,
47
+ }, ApiPhotoList);
48
+ const pagination = derivePagination({
49
+ page: args.page,
50
+ per_page: args.per_page,
51
+ count: value.photos.length,
52
+ total_results: value.total_results,
53
+ hasNextHint: Boolean(value.next_page),
54
+ });
55
+ const results = value.photos.map((photo) => presentPhoto(photo, args.detail));
56
+ const text = results.length === 0
57
+ ? `No photos matched "${truncate(args.query, 60)}".\n${SEARCH_HINTS.map((hint) => `- ${hint}`).join('\n')}`
58
+ : joinBlocks(listHeader('photos', pagination, results.length), results.map((photo) => photoBlock(photo, args.detail)), listFooter(pagination));
59
+ return {
60
+ text,
61
+ structured: { count: results.length, pagination, results },
62
+ count: results.length,
63
+ cacheHit,
64
+ };
65
+ }));
66
+ }
67
+ //# sourceMappingURL=search-photos.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-photos.js","sourceRoot":"","sources":["../../src/tools/search-photos.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import { z } from 'zod';
2
+ import { listFooter, listHeader } from '../present/envelope.js';
3
+ import { joinBlocks, truncate } from '../present/util.js';
4
+ import { presentVideo, videoBlock } from '../present/video.js';
5
+ import { collapseWhitespace, derivePagination } from '../pexels/quirks.js';
6
+ import { ApiVideoList } from '../pexels/schemas.js';
7
+ import { Detail, Orientation, PageInput, PerPageInput, Size, VideoListOut } from '../types.js';
8
+ import { READ_ONLY_ANNOTATIONS, SEARCH_HINTS, runTool } from './helpers.js';
9
+ export const searchVideosInput = z.object({
10
+ query: z
11
+ .string()
12
+ .transform(collapseWhitespace)
13
+ .pipe(z
14
+ .string()
15
+ .min(1, 'query must not be empty — describe what to search for')
16
+ .max(200, 'query must be at most 200 characters'))
17
+ .describe('Search terms, e.g. "ocean waves"'),
18
+ orientation: Orientation.optional().describe('landscape, portrait, or square'),
19
+ size: Size.optional().describe('Video resolution: large = 4K, medium = 1080p, small = 480p'),
20
+ locale: z.string().optional().describe('Locale such as en-US or es-ES'),
21
+ page: PageInput,
22
+ per_page: PerPageInput,
23
+ detail: Detail,
24
+ });
25
+ export function registerSearchVideos(server, ctx) {
26
+ server.registerTool('search_videos', {
27
+ title: 'Search videos',
28
+ description: 'Search Pexels stock videos. Brief mode reports the single best file per video; detail="full" lists every quality with fps.',
29
+ inputSchema: searchVideosInput,
30
+ outputSchema: VideoListOut,
31
+ annotations: READ_ONLY_ANNOTATIONS,
32
+ }, async (args) => runTool('search_videos', async () => {
33
+ const { value, cacheHit } = await ctx.client.get('/videos/search', {
34
+ query: args.query,
35
+ orientation: args.orientation,
36
+ size: args.size,
37
+ locale: args.locale ?? ctx.config.locale,
38
+ page: args.page,
39
+ per_page: args.per_page,
40
+ }, ApiVideoList);
41
+ const pagination = derivePagination({
42
+ page: args.page,
43
+ per_page: args.per_page,
44
+ count: value.videos.length,
45
+ total_results: value.total_results,
46
+ hasNextHint: Boolean(value.next_page),
47
+ });
48
+ const results = value.videos.map((video) => presentVideo(video, args.detail));
49
+ const text = results.length === 0
50
+ ? `No videos matched "${truncate(args.query, 60)}".\n${SEARCH_HINTS.map((hint) => `- ${hint}`).join('\n')}`
51
+ : joinBlocks(listHeader('videos', pagination, results.length), results.map((video) => videoBlock(video, args.detail)), listFooter(pagination));
52
+ return {
53
+ text,
54
+ structured: { count: results.length, pagination, results },
55
+ count: results.length,
56
+ cacheHit,
57
+ };
58
+ }));
59
+ }
60
+ //# sourceMappingURL=search-videos.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-videos.js","sourceRoot":"","sources":["../../src/tools/search-videos.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,118 @@
1
+ import { z } from 'zod';
2
+ /** Two levels of detail: `brief` is the default and keeps tool output small. */
3
+ export const Detail = z.enum(['brief', 'full']).default('brief');
4
+ export const Orientation = z.enum(['landscape', 'portrait', 'square']);
5
+ export const Size = z.enum(['large', 'medium', 'small']);
6
+ export const MediaType = z.enum(['photos', 'videos']);
7
+ export const PAGE_DEFAULT = 1;
8
+ export const PER_PAGE_DEFAULT = 15;
9
+ export const PER_PAGE_MAX = 80;
10
+ export const PageInput = z
11
+ .number()
12
+ .int('page must be a whole number')
13
+ .min(1, 'page starts at 1')
14
+ .default(PAGE_DEFAULT)
15
+ .describe('Page number, starting at 1');
16
+ export const PerPageInput = z
17
+ .number()
18
+ .int('per_page must be a whole number')
19
+ .min(1, 'per_page must be between 1 and 80')
20
+ .max(PER_PAGE_MAX, 'per_page must be between 1 and 80')
21
+ .default(PER_PAGE_DEFAULT)
22
+ .describe('Results per page (1–80)');
23
+ /** Pagination is always expressed as page numbers, never as upstream URLs. */
24
+ export const Pagination = z.object({
25
+ page: z.number().int(),
26
+ per_page: z.number().int(),
27
+ total_results: z.number().int().optional(),
28
+ next_page: z.number().int().optional(),
29
+ prev_page: z.number().int().optional(),
30
+ });
31
+ const Url = z.url();
32
+ export const Photographer = z.object({
33
+ name: z.string(),
34
+ url: Url,
35
+ id: z.number().int(),
36
+ });
37
+ export const PhotoOut = z.object({
38
+ type: z.literal('photo'),
39
+ id: z.number().int(),
40
+ width: z.number().int(),
41
+ height: z.number().int(),
42
+ aspect_ratio: z.string(),
43
+ orientation: Orientation,
44
+ alt: z.string().nullable(),
45
+ photographer: Photographer,
46
+ page_url: Url,
47
+ preview_url: Url,
48
+ download_url: Url,
49
+ avg_color: z.string().nullable().optional(),
50
+ liked: z.boolean().optional(),
51
+ renditions: z.record(z.string(), Url).optional(),
52
+ });
53
+ /** Result of asking for a derived (resized/cropped) rendition URL. */
54
+ export const PhotoUrlOut = z.object({
55
+ id: z.number().int(),
56
+ url: Url,
57
+ width: z.number().int().nullable(),
58
+ height: z.number().int().nullable(),
59
+ fit: z.enum(['crop', 'max']).nullable(),
60
+ source: z.object({
61
+ page_url: Url,
62
+ original_url: Url,
63
+ width: z.number().int(),
64
+ height: z.number().int(),
65
+ }),
66
+ });
67
+ export const VideoFileOut = z.object({
68
+ quality: z.string(),
69
+ width: z.number().int().nullable(),
70
+ height: z.number().int().nullable(),
71
+ fps: z.number().nullable(),
72
+ size_mb: z.number().nullable(),
73
+ content_type: z.string().nullable(),
74
+ url: Url,
75
+ });
76
+ export const VideoOut = z.object({
77
+ type: z.literal('video'),
78
+ id: z.number().int(),
79
+ width: z.number().int(),
80
+ height: z.number().int(),
81
+ aspect_ratio: z.string(),
82
+ orientation: Orientation,
83
+ duration_seconds: z.number().int(),
84
+ creator: Photographer,
85
+ page_url: Url,
86
+ thumbnail_url: Url,
87
+ files: z.array(VideoFileOut),
88
+ tags: z.array(z.string()).optional(),
89
+ pictures: z
90
+ .array(z.object({
91
+ url: Url,
92
+ index: z.number().int(),
93
+ }))
94
+ .optional(),
95
+ });
96
+ export const CollectionOut = z.object({
97
+ type: z.literal('collection'),
98
+ id: z.string(),
99
+ title: z.string(),
100
+ description: z.string().nullable(),
101
+ private: z.boolean(),
102
+ media_count: z.number().int(),
103
+ photos_count: z.number().int(),
104
+ videos_count: z.number().int(),
105
+ });
106
+ /** Uniform envelope for every list-returning tool. */
107
+ export function listOutput(results) {
108
+ return z.object({
109
+ count: z.number().int(),
110
+ pagination: Pagination,
111
+ results: z.array(results),
112
+ });
113
+ }
114
+ export const PhotoListOut = listOutput(PhotoOut);
115
+ export const VideoListOut = listOutput(VideoOut);
116
+ export const CollectionListOut = listOutput(CollectionOut);
117
+ export const MediaListOut = listOutput(z.discriminatedUnion('type', [PhotoOut, VideoOut]));
118
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import { createRequire } from 'node:module';
2
+ const require = createRequire(import.meta.url);
3
+ const pkg = require('../package.json');
4
+ export const VERSION = pkg.version ?? '0.0.0';
5
+ export const SERVER_NAME = 'pexels-mcp';
6
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@rahmandayub/pexels-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.1",
4
+ "description": "MCP server for the Pexels photo & video API — compact results, honest pagination, actionable errors.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "bin": {
8
+ "pexels-mcp": "dist/index.js"
9
+ },
10
+ "main": "dist/index.js",
11
+ "files": [
12
+ "dist",
13
+ "README.md"
14
+ ],
15
+ "engines": {
16
+ "node": ">=22"
17
+ },
18
+ "keywords": [
19
+ "mcp",
20
+ "model-context-protocol",
21
+ "pexels",
22
+ "stock-photos",
23
+ "stock-video",
24
+ "ai-agent"
25
+ ],
26
+ "author": "Rahmandayub",
27
+ "scripts": {
28
+ "prepublishOnly": "npm run lint && npm run typecheck && npm test && npm run build",
29
+ "build": "tsc -p tsconfig.json",
30
+ "dev": "tsx watch src/index.ts",
31
+ "start": "node dist/index.js",
32
+ "test": "vitest run",
33
+ "test:watch": "vitest",
34
+ "test:live": "PEXELS_LIVE=1 vitest run test/live",
35
+ "typecheck": "tsc -p tsconfig.test.json",
36
+ "lint": "eslint .",
37
+ "fixtures": "tsx scripts/record-fixtures.ts"
38
+ },
39
+ "dependencies": {
40
+ "@modelcontextprotocol/server": "^2.4.0",
41
+ "zod": "^4.6.7"
42
+ },
43
+ "devDependencies": {
44
+ "@eslint/js": "^9.0.0",
45
+ "@modelcontextprotocol/client": "^2.4.0",
46
+ "@types/node": "^24.0.0",
47
+ "eslint": "^9.0.0",
48
+ "globals": "^15.0.0",
49
+ "tsx": "^4.20.0",
50
+ "typescript": "^5.9.0",
51
+ "typescript-eslint": "^8.0.0",
52
+ "vitest": "^3.0.0"
53
+ }
54
+ }