使用说明
图像搜索MCP
一种模型上下文协议（MCP）服务器，提供对多个股票媒体服务的统一访问。通过单一界面从Pexels、Envato等搜索照片和视频。
特性
- 统一搜索：使用一个命令查询多个股票媒体服务
- MCP集成：直接在Claude Code和其他MCP客户端中使用
- CLI支持：独立命令行界面
- 可扩展：通过适配器模式轻松添加新服务
- 缓存：使用智能缓存减少API调用
支持服务列表
| 服务 | 照片 | 视频 | 状态 |
|---|---|---|---|
| Pexels | 是 | 是 | 计划中 |
| Envato元素 | 是 | 是 | 计划中 |
| Unsplash | 是 | 否 | 未来 |
| Pixabay | 是 | 是 | 未来 |
快速开始
安装
# Clone and install
cd ~/dev2/image-search-mcp
npm install
npm run build
# Add to Claude Code
claude mcp add image-search -- node ~/dev2/image-search-mcp/dist/index.js
配置
设置API密钥：
export PEXELS_API_KEY="your-pexels-key"
export ENVATO_TOKEN="your-envato-token"
Claude中的用法
Search for AI technology photos using image-search
CLI使用情况
# Search photos
image-search search "AI technology" --type photo
# Search videos from specific service
image-search search "abstract blue" --service pexels --type video
# List configured services
image-search services
文档
- 要求.md -功能和技术规格
- 设置.md -安装和配置指南
- ROADMAP.md -开发阶段和时间表
- TODO.md -可操作任务清单
建筑
src/
├── index.ts # MCP server entry
├── cli.ts # CLI entry
├── core/
│ ├── types.ts # Shared interfaces
│ ├── registry.ts # Adapter registry
│ ├── cache.ts # Caching layer
│ └── search.ts # Search orchestrator
└── adapters/
├── base.ts # Abstract adapter
├── pexels.ts # Pexels implementation
└── envato.ts # Envato implementation
发展
# Run in development mode
npm run dev
# Run tests
npm test
# Type check
npm run typecheck
贡献
- 克隆该仓库
- 创建要素分支
- 通过测试实施
- 提交拉取请求
许可证
麻省理工学院
