https://github.com/nota/gyazo-mcp-server
Official Model Context Protocol server for Gyazo
https://github.com/nota/gyazo-mcp-server
Last synced: 5 months ago
JSON representation
Official Model Context Protocol server for Gyazo
- Host: GitHub
- URL: https://github.com/nota/gyazo-mcp-server
- Owner: nota
- License: mit
- Created: 2025-01-26T05:32:38.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-05-13T08:00:46.000Z (5 months ago)
- Last Synced: 2025-05-13T08:33:41.674Z (5 months ago)
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@notainc/gyazo-mcp-server
- Size: 130 KB
- Stars: 17
- Watchers: 8
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Gyazo Server - A TypeScript-based MCP server enabling AI assistants to interact with Gyazo images using the Model Context Protocol (MCP), providing access to image URIs, metadata, and OCR data via the Gyazo API. Highly relevant as a specialized MCP server implementation. ([Read more](/details/gyazo-server.md)) `image-management` `gyazo` `mcp` `ai-assistant` `api-integration` (Media Processing MCP Servers)
- Awesome-Official-MCP-Servers - Gyazo - mcp-server?style=social) | Search, fetch, upload, and interact with Gyazo images, including metadata and OCR data. | | (官方 MCP 服务器列表)
- mcp-index - Gyazo Image Integration Server - Access and manage Gyazo images and their associated metadata, including OCR data, through a standardized protocol. Enables full-text search and retrieval of images using URIs. (APIs and HTTP Requests)
- Awesome-Official-MCP-Servers - Gyazo - mcp-server?style=social) | Search, fetch, upload, and interact with Gyazo images, including metadata and OCR data. | | (官方 MCP 服务器列表)
README
# gyazo-mcp-server
A Model Context Protocol server for Gyazo image integration
This is a TypeScript-based MCP server that provides access to Gyazo images. It allows AI assistants to access and interact with Gyazo images through the Model Context Protocol, providing:
- Resources representing Gyazo images with URIs and metadata
- Tools for searching, fetching, and uploading images
- Image content and metadata access via the Gyazo API
## Features
### Resources
- List and access Gyazo images via `gyazo-mcp://` URIs
- Each image includes:
- Original image content
- Metadata (title, description, app, URL)
- OCR data (if available)
- Supports various image formats (JPEG, PNG, etc.)
### Tools
- `gyazo_search` - Full-text search for captures uploaded by users on Gyazo
- Search by keyword, title, app, URL, or date range
- Supports pagination for browsing multiple results
- Returns matching image URIs and metadata
- `gyazo_image` - Fetch image content and metadata from Gyazo
- Retrieve specific images by ID or URL
- Returns both image content and detailed metadata
- `gyazo_latest_image` - Fetch the most recent image from Gyazo
- Returns both image content and metadata
- Includes OCR text if available
- `gyazo_upload` - Upload an image to Gyazo
- Upload images with base64 encoded image data
- Add optional metadata like title, description, referer URL, and app name
- Returns the uploaded image's permalink URL and ID
## Installation
### NPM Package
The easiest way to install the Gyazo MCP server is via npm:
```bash
npm install -g @notainc/gyazo-mcp-server
```
### Prerequisites
- Create a Gyazo account if you don't have one: https://gyazo.com
- Get your Gyazo API access token from: https://gyazo.com/api
- Click "Register applications" button
- Click "New Application" button
- Fill in the form with your app name and description
- Name and Callback URL are required
- You can use `http://localhost` for the Callback URL
- Click "Submit" button
- Click application name to view details
- Scroll down to "Your Access Token"
- Click "Generate" button
- Copy "Your access token" value
- Set the `GYAZO_ACCESS_TOKEN` environment variable with your token
### Claude Desktop Integration
To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
#### Using NPM package (recommended)
```json
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "npx",
"args": ["@notainc/gyazo-mcp-server"],
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
```
#### Using Docker (optional)
```json
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GYAZO_ACCESS_TOKEN",
"gyazo-mcp-server"
],
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
```
## Development
Install dependencies:
```bash
npm ci
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
npm run watch
```
### Docker Build (optional)
```bash
npm run image:build
```
---
