Multi-Source-Media-MCP-Server: Instructions file for Gemini CLI

Gemini Memories

Multi-Source Media Tool Server – Requirements Document

1. Project Name

Multi-Source Media MCP Server (M3S) An MCP Tool Implementation for Multi-Source Image and Video Access & Generation

---

2. Project Overview

This project is an MCP (Model Context Protocol) tool implementation, designed to provide a unified interface for large models (e.g., Gemini, LangChain, ChatGPT Agents, etc.) to access and generate images and videos from multiple sources.

⚠️ Note: This is not a traditional backend service, but an MCP tool server that exposes its capabilities via the MCP SDK.

Project Goals

• Provide unified image/video access and generation capabilities for large models
• Offer transparent access to diverse content sources (3rd-party APIs, web crawlers, user uploads, AI generation)
• Ensure security, scalability, and maintainability
• Maintain comprehensive logging and request traceability

---

3. Development Environment

• Language: Go 1.25.1
• MCP SDK: go-sdk
• Additional Dependencies: HTTP client, environment variable management, and a shared utility package for generic MCP tool response handling.
• Project Structure: Modular design, for example (can be adjusted and optimized as needed) :

gemini-mcp/
├── cmd/
│   └── server/
│       └── main.go               # Program entry point, initializes MCP Server
│
├── mcp/
│   ├── server.go                 # Creates MCP server instance, registers all tools
│   └── middleware/
│       └── logging.go            # Logging middleware for MCP tools
│   └── tools/
│       ├── pexels/
│       │   ├── client.go         # Pexels API client implementation
│       │   ├── handler.go        # MCP tool handlers for Pexels API
│       │   └── schema.go         # Defines Pexels tool input/output JSON schemas
│       │
│       ├── test_greet/
│       │   ├── handler.go        # Implements "greet" tool logic
│       │   └── schema.go         # Defines greet tool input/output JSON schemas
│       │
│       └── tool_xxx/             # Placeholder for other tools
│           ├── handler.go
│           └── schema.go
│
├── test/
│   ├── tool_greet_test.go        # Unit tests for greet tool
│   ├── tool_summary_test.go      # Unit tests for summary tool
│   └── integration_test.go       # Integration tests (run after feature development)
│
├── config/
│   └── config.go                 # (Optional) Configuration loading, API Key, environment variables
│
├── utils/
│   ├── env.go                    # Utility functions for environment variable expansion
│   ├── logger.go                 # General utility functions (logging, error handling, etc.)
│   └── mcp_tool_response.go      # Generic handler for MCP tool responses (e.g., TextContent)
│
├── go.mod
├── go.sum
└── README.md