Gyazo Mcp Server

内容官方认证远程 TypeScript

🚀 gyazo-mcp-server

gyazo-mcp-server 是一个用于集成Gyazo图像的模型上下文协议（MCP）服务器。它基于TypeScript构建，允许AI助手通过Model Context Protocol交互访问和操作Gyazo图像，为用户提供了便捷的图像管理与使用体验。

🚀 快速开始

gyazo-mcp-server 是一个基于TypeScript构建的MCP服务器，专门用于提供对Gyazo图像的访问。它借助Model Context Protocol，让AI助手能够轻松地访问和操作Gyazo图像，涵盖通过特定URI表示图像资源、使用工具搜索与上传图像，以及借助Gyazo API获取图像内容和元数据等功能。

✨ 主要特性

资源

图像访问：可使用 gyazo-mcp:// URI列举并访问Gyazo图像。
丰富信息：每张图像包含原始图像内容、元数据（标题、描述、应用、URL）以及OCR数据（若有可用）。
多格式支持：支持多种常见图像格式，如JPEG、PNG等。

工具

gyazo_search：可按全文搜索用户在Gyazo上传的捕获，支持按关键词、标题、应用、URL或日期范围搜索，还能分页浏览多个结果，最终返回匹配图像的URI和元数据。
gyazo_image：能从Gyazo获取图像内容及元数据，可按ID或URL检索特定图像，并返回图像内容及详细元数据。
gyazo_latest_image：用于获取Gyazo最新的图像，返回图像内容、元数据以及可用的OCR文本。
gyazo_upload：可向Gyazo上传图像，使用base64编码的图像数据进行上传，还能可选添加标题、描述、referrer URL和应用名称等元数据，最后返回上传图像的永久链接URL和ID。

📦 安装指南

NPM包

通过npm安装Gyazo MCP服务器是最为简便的方式：

npm install -g @notainc/gyazo-mcp-server

先决条件

若您还没有Gyazo账户，请先前往 Gyazo注册页面进行注册。
获取您的Gyazo API访问令牌：
1. 访问 Gyazo API页面。
2. 点击“注册应用”按钮。
3. 点击“新建应用”按钮。
4. 填写表单，其中名称和回调URL为必填项，您可以使用 http://localhost 作为回调URL。
5. 点击“提交”按钮。
6. 点击应用查看详细信息。
7. 向下滚动到“您的访问令牌”。
8. 点击“生成”按钮。
9. 复制“您的访问令牌”值。
设置环境变量 GYAZO_ACCESS_TOKEN 为您的令牌。

Claude桌面集成

若要与Claude Desktop一起使用，需添加服务器配置：

在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

docker run -it --rm -p 3000:3000 -e GYAZO_API_KEY=your_access_token_here notational/gyazo-mcp-server

💻 使用示例

基础用法

以下是使用 gyazo_search 工具按关键词搜索图像的示例：

# 假设搜索关键词为 "example"
gyazo_search --keyword "example"

高级用法

以下是使用 gyazo_upload 工具上传图像并添加元数据的示例：

# 假设使用base64编码的图像数据存储在 image_data.txt 文件中
base64_image=$(cat image_data.txt)
gyazo_upload --image "$base64_image" --title "Example Image" --description "This is an example image" --referrer "http://example.com" --app "Example App"

📚 详细文档

开发

构建

克隆仓库：

git clone <仓库地址>

安装依赖：

npm install

运行开发服务器：

npm run dev

脚本

npm run dev：在开发模式下运行服务器。
npm run build：构建生产版本。
npm run test：运行测试。
npm run lint：执行代码检查。

Docker

若要使用Docker，请参考 notational/gyazo-mcp-server。

0 条评论
分类：内容