Skip to main content
Glama
Sign In
enesjakozh

Unsplash API MCP Server

by gzpaitch
GitHub
Python
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports environment configuration through .env files for storing API keys and other settings.

  • Offers containerized deployment with Docker and docker-compose for easier setup and distribution.

  • Uses FastAPI as the web framework to implement the MCP server endpoints and API functionality.

Unsplash API - FastAPI + FastMCP

由 @aliosmankaya 从 unsplash-api派生而来

目录

概述

该项目提供了访问 Unsplash 服务的 API，允许您搜索、列出和获取随机图像。此外，它集成了模型上下文协议 (MCP)，使 Claude 等 AI 模型能够直接与 Unsplash API 交互。

FastAPI-MCP FastAPI

先决条件

在使用 Unsplash API 之前，您需要：

  1. 在 Unsplash 上注册为开发者
  2. 获取您的访问密钥
  3. 在.env文件中将密钥配置为UNSPLASH_CLIENT_ID

安装

使用 pip

# Clone the repository git clone https://github.com/your-username/unsplash-api-mcp.git cd unsplash-api-mcp # Install dependencies pip install -r requirements.txt # Configure environment variables cp .env.example .env # Edit the .env file and add your UNSPLASH_CLIENT_ID

使用 Docker

# Clone the repository git clone https://github.com/your-username/unsplash-api-mcp.git cd unsplash-api-mcp # Configure environment variables cp .env.example .env # Edit the .env file and add your UNSPLASH_CLIENT_ID # Build and start the container docker compose up -d

配置

在项目根目录中创建一个.env文件，其内容如下：

UNSPLASH_CLIENT_ID=your_access_key_here

跑步

本地

python main.py

API 将在http://localhost:8000上可用。

使用 Docker

docker compose up -d

API 将在http://localhost:8000上可用。

访问http://localhost:8000/docs上的交互式 API 文档。

API 端点

搜索

在 Unsplash 上搜索图像的端点。

端点： /search

方法： GET

参数：

  • query ：搜索词（默认值：“nature”）
  • page ：页码（默认值：1）
  • per_page ：每页照片数量（默认值：10）
  • order_by ：照片排序（默认值：“relevant”，选项：“relevant”、“latest”）

请求示例：

GET /search?query=mountains&page=1&per_page=5&order_by=latest

响应示例：

[ { "alt_description": "mountain range under cloudy sky", "created_at": "2023-05-15T12:34:56Z", "username": "Photographer Name", "image_link": "https://images.unsplash.com/photo-...", "download_link": "https://unsplash.com/photos/...", "likes": 123 }, ... ]

照片

用于列出来自 Unsplash 登录页面的照片的端点。

端点： /photos

方法： GET

参数：

  • page ：页码（默认值：1）
  • per_page ：每页照片数量（默认值：10）
  • order_by ：照片排序（默认值：“最新”，选项：“最新”、“最旧”、“热门”）

请求示例：

GET /photos?page=1&per_page=5&order_by=popular

响应示例：

[ { "alt_description": "scenic view of mountains during daytime", "created_at": "2023-06-20T10:15:30Z", "username": "Photographer Name", "image_link": "https://images.unsplash.com/photo-...", "download_link": "https://unsplash.com/photos/...", "likes": 456 }, ... ]

随机的

从 Unsplash 获取随机照片的端点。

端点： /random

方法： GET

参数：

  • query ：用于过滤随机照片的搜索词（默认值：“自然”）
  • count ：返回的照片数量（默认值：1，最大值：30）

请求示例：

GET /random?query=ocean&count=3

响应示例：

[ { "alt_description": "blue ocean waves crashing on shore", "created_at": "2023-04-10T08:45:22Z", "username": "Photographer Name", "image_link": "https://images.unsplash.com/photo-...", "download_link": "https://unsplash.com/photos/...", "likes": 789 }, ... ]

有关 Unsplash API 的更多信息，请参阅官方文档。

MCP 集成

MCP 概述

模型上下文协议 (MCP) 是一种允许 AI 模型直接与 API 和服务交互的协议。此实现使用FastAPI-MCP将 Unsplash API 端点公开为 MCP 工具。

MCP 端点

MCP 服务器位于/mcp ，并将所有 API 端点公开为 MCP 工具：

  • 搜索：在 Unsplash 上搜索图片
  • 照片：列出着陆页上的照片
  • random ：获取随机照片

与 AI 模型一起使用

支持 MCP 的 AI 模型可以使用以下方式连接到此 API：

http://your-server:8000/mcp

对于 Claude，您可以在模型设置中或通过 API 配置连接。

示例客户端

您可以使用简单的 Python 客户端测试 MCP 服务器：

import requests def test_mcp_metadata(): """Test if the MCP server is working correctly.""" response = requests.get("http://localhost:8000/mcp/.well-known/mcp-metadata") if response.status_code == 200: print("MCP server working correctly!") print(f"Response: {response.json()}") else: print(f"Error: {response.text}") def list_mcp_tools(): """List the available tools in the MCP server.""" response = requests.post( "http://localhost:8000/mcp/jsonrpc", json={ "jsonrpc": "2.0", "id": 1, "method": "mcp/list_tools" } ) if response.status_code == 200: print("Available MCP tools:") for tool in response.json()["result"]["tools"]: print(f"- {tool['name']}: {tool['description']}") else: print(f"Error: {response.text}") if __name__ == "__main__": test_mcp_metadata() list_mcp_tools()

有关使用 MCP 的更多信息，请参阅MCP_USAGE.md文件。

发展

为发展做出贡献：

  1. 克隆存储库
  2. 安装开发依赖项： pip install -r requirements.txt
  3. 使用你的 Unsplash API 密钥创建一个.env文件
  4. 以开发模式运行服务器： python main.py

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

一个将 Unsplash 图像搜索、列表和随机照片功能作为 MCP 工具公开的 API，使 Claude 等 AI 模型能够直接与 Unsplash 的服务进行交互。

  1. 目录
    1. 概述
      1. 先决条件
        1. 安装
          1. 使用 pip
          2. 使用 Docker
        2. 配置
          1. 跑步
            1. 本地
            2. 使用 Docker
          2. API 端点
            1. 搜索
            2. 照片
            3. 随机的
          3. MCP 集成
            1. MCP 概述
            2. MCP 端点
            3. 与 AI 模型一起使用
            4. 示例客户端
          4. 发展
            1. 执照

              Related MCP Servers

              • mcp-image-downloader

                qpd-v
                A
                security
                A
                license
                A
                quality
                Enables AI assistants to download images from URLs and perform basic image optimization tasks.
                Last updated -
                2
                4
                JavaScript
                Apache 2.0

              • Together AI Image MCP Server

                stefanskiasan
                A
                security
                A
                license
                A
                quality
                Enables the generation of images using Together AI's models through an MCP server, supporting customizable parameters such as model selection, image dimensions, and output directory.
                Last updated -
                1
                4
                JavaScript
                MIT License
                • Apple
                • Linux

              • MCP Server for Replicate

                tzafrir
                -
                security
                A
                license
                -
                quality
                A FastMCP server implementation that provides a standardized interface for accessing AI models hosted on Replicate's API, currently supporting image generation with customizable parameters.
                Last updated -
                2
                Python
                MIT License

              • Unsplash MCP Server

                hellokaton
                A
                security
                A
                license
                A
                quality
                A lightweight server that enables seamless integration with Unsplash's image library, allowing developers to search for high-quality photos with various filters directly from the Cursor editor.
                Last updated -
                1
                112
                Python
                MIT License

              View all related MCP servers

              ID: y52408fr3d