🚀 gyazo-mcp-server
Gyazo图片集成为Model Context Protocol（MCP）服务器，此项目基于TypeScript构建，能让AI助手借助模型上下文协议对Gyazo图像进行访问与交互，为图像的使用提供了便捷途径。
🚀 快速开始
这是一个基于TypeScript构建的MCP服务器，提供对Gyazo图像的访问。它允许AI助手通过模型上下文协议访问和交互使用Gyazo图像，包括通过gyazo-mcp:// URI及其元数据表示Gyazo图片、提供搜索、获取和上传图片的功能，以及通过Gyazo API访问图片内容和元数据。
✨ 主要特性
资源
- 可列出并访问使用
gyazo-mcp://URI的Gyazo图片。 - 每张图片包含以下内容：
- 原始图片内容
- 元数据（标题、描述、应用、URL）
- 可用的OCR数据（若存在）
工具
gyazo_search：对用户在Gyazo上传的所有捕获进行全文搜索。- 支持按关键字、标题、应用、URL或时间范围搜索。
- 支持分页浏览多个结果。
- 返回匹配图片的URI和元数据。
gyazo_image：从Gyazo获取特定图片的内容和元数据。- 可使用ID或URL检索特定图片。
- 返回图片内容和详细元数据。
gyazo_latest_image：获取Gyazo最新上传的图片。- 返回包含OCR文本（若有）的图片内容和元数据。
gyazo_upload：将图片上传到Gyazo。- 使用base64编码的图片数据上传。
- 可选择添加标题、描述、引用URL和应用名称等元数据。
- 返回上传图片的永久链接URL和ID。
📦 安装指南
NPM包
通过NPM安装Gyazo MCP服务器是最简单的方式：
npm install -g @notainc/gyazo-mcp-server
先决条件
- 若没有Gyazo账户，请先注册：https://gyazo.com
- 从Gyazo获取API访问令牌：https://gyazo.com/api
- 点击“注册应用”按钮。
- 点击“新建应用”按钮。
- 填写表单（名称和回调URL为必填），使用
http://localhost作为回调URL。 - 点击“提交”按钮。
- 返回到应用列表，点击应用名称查看详细信息。
- 滚动到底部，找到“您的访问令牌”。
- 点击“生成”按钮。
- 复制“您的访问令牌”的值。
- 设置
GYAZO_ACCESS_TOKEN环境变量为您的令牌。
Claude Desktop集成
要与Claude桌面一起使用，请添加服务器配置：
- 在MacOS中：
~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows中：
%APPDATA%/Claude/claude_desktop_config.json
使用NPM包（推荐）
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "npx",
"args": ["@notainc/gyazo-mcp-server"],
"env": {
"GYAZO_ACCESS_TOKEN": "your-access-token-here"
}
}
}
}
使用Docker（可选）
{
"mcpServers": {
"gyazo-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GYAZO_ACCESS_TOKEN=your-access-token-here",
"@notainc/gyazo-mcp-server"
]
}
}
}
🔧 技术细节
- 在开发过程中，使用
npm run dev启动调试服务器。 - 使用
npm test进行测试。