Pexels MCP Server

这是一个提供对Pexels API访问的Model Context Protocol服务器，用于搜索和检索照片、视频和集合。

可用工具

• photos_search – 搜索照片
• photos_curated – 列出精选照片
• photo_get – 通过ID获取照片
• videos_search – 搜索视频
• videos_popular – 列出热门视频
• video_get – 通过ID获取视频
• collections_featured – 列出特色集合
• collections_media – 列出集合中的媒体

使用方法

使用 uv（推荐）

1. 安装uv。

2. 在您的MCP客户端代码配置或Claude设置（文件claude_desktop_config.json）中添加pexels MCP服务器：

   {
       "mcpServers": {
           "pexels": {
               "command": "uvx",
               "args": ["pexels-mcp-server"],
               "env": {
                   "PEXELS_API_KEY": "<您的 Pexels API 密钥>"
               }
           }
       }
   }
   

   uv将使用uvx从pypi.org自动下载MCP服务器并应用于您的MCP客户端。

使用 pip 为项目

1. 将pexels-mcp-server添加到您的MCP客户端代码的requirements.txt文件中。

   pexels-mcp-server
   

2. 安装依赖项。

   pip install -r requirements.txt
   

3. 添加客户端配置：

   {
       "mcpServers": {
           "pexels": {
               "command": "python3",
               "args": ["-m", "pexels_mcp_server"],
               "env": {
                   "PEXELS_API_KEY": "<您的 Pexels API 密钥>"
               }
           }
       }
   }
   

全局使用 pip

1. 确保系统上可用pip或pip3。

   pip install pexels-mcp-server
   # 或
   pip3 install p
   

2. MCP客户端代码配置或Claude设置，添加pexels MCP服务器：

   {
       "mcpServers": {
           "pexels": {
               "command": "python3",
               "args": ["pexels-mcp-server"],
               "env": {
                   "PEXELS_API_KEY": "<您的 Pexels API 密钥>"
               }
           }
       }
   }
   

调试

您可以使用MCP检查器来调试服务器。对于uvx安装：

npx @modelcontextprotocol/inspector uvx pexels-mcp-server

或者如果您在特定目录中安装了该包或正在开发它：

git clone https://github.com/garylab/pexels-mcp-server.git
cd pexels-mcp-server
npx @modelcontextprotocol/inspector uv run pexels-mcp-server -e PEXELS_API_KEY=<密钥>

许可证

pexels-mcp-server根据MIT许可证授权。这意味着您可以在遵守MIT许可证条款和条件的情况下自由使用、修改和分发软件。更多详情，请参见项目存储库中的LICENSE文件。