https://github.com/yuiseki/gyazo-mcp-server
A Model Context Protocol server for Gyazo
https://github.com/yuiseki/gyazo-mcp-server
Last synced: 7 months ago
JSON representation
A Model Context Protocol server for Gyazo
- Host: GitHub
- URL: https://github.com/yuiseki/gyazo-mcp-server
- Owner: yuiseki
- License: mit
- Created: 2025-01-26T05:32:38.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-30T10:31:06.000Z (7 months ago)
- Last Synced: 2025-03-30T11:26:52.911Z (7 months ago)
- Language: JavaScript
- Homepage:
- Size: 56.6 KB
- Stars: 6
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **gyazo-mcp-server** - Official Model Context Protocol server for Gyazo `typescript` `server` `npm install yuiseki/gyazo-mcp-server` (🌐 Web Development)
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 fetching the latest image
- 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_latest_image` - Fetch the most recent image from Gyazo
- Returns both image content and metadata
- Includes OCR text if available
## Development
Install dependencies:
```bash
npm install
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
npm run watch
```
### Docker
```bash
npm run image:build
```
## Installation
### Prerequisites
1. Create a Gyazo account if you don't have one: https://gyazo.com
2. Get your Gyazo API access token from: https://gyazo.com/api
3. 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`
```json
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "/path/to/gyazo-mcp-server/build/index.js",
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
```
#### Docker
```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"
}
}
}
}
```
### Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:
```bash
npm run inspector
```
The Inspector will provide a URL to access debugging tools in your browser.
---
