yourimageshare

yourimageshare-mcp

适用于 YourImageShare 的 MCP（Model Context Protocol）服务。 专为 AI 编码 Agent（Claude Code、Cursor 及其他兼容 MCP 的 工具）打造——在错误报告、PR 描述或支持帖中粘贴截图时，可使用真实 URL，而不是 base64 数据块或手动上传。 它也能以相同方式与 Claude Desktop 及其他 MCP 客户端配合使用。

• 获取 API 密钥： 登录并打开 yourimageshare.com/my-account 中的 API 标签页。
• 完整 HTTP 参考： yourimageshare.com/about/api。
• OpenAPI 3.1 规范： yourimageshare.com/openapi.json， 如果你的工具更适合使用它，而不是本 README。

安装 / 运行

无需安装——直接使用 npx 运行：

npx yourimageshare-mcp

也已列在 Smithery 上，如果你的 MCP 客户端从那里安装。

Claude Desktop / Claude Code 配置

添加到 MCP 客户端的配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "yourimageshare": {
      "command": "npx",
      "args": ["-y", "yourimageshare-mcp"],
      "env": {
        "YIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

环境变量

变量	必填	用途
YIS_API_KEY	是	你的 YourImageShare API 密钥。
YIS_BASE_URL	否	覆盖 API 基础 URL（默认值为 https://yourimageshare.com/api）。仅用于测试。

工具

upload_image

上传文件（最大 200 MB——超过 90 MB 的文件会自动分段发送）。请恰好提供以下一项：

• path - 此服务进程可读取的本地文件路径，
• base64 + filename - 内联文件内容，适用于无法访问本地文件系统的 MCP 客户端，或
• url - YourImageShare 服务自行下载的公开 http(s) 链接。

可选的 expiresIn（秒，60 到 2,592,000 = 30 天）用于设置上传内容自动删除的时间。如果账户已上传过完全相同的文件，则返回现有上传内容并附带 duplicate: true；设置 allowDuplicate 可存储新副本。返回 id、type、path、src、direct、thumb（280 px WebP 缩略图）、width、height、size、locked、expires_at 和 duplicate——请保存 src，因为转换后 path 可能会发生变化。

还可选用：visibility（默认值为 unlisted——知道链接的任何人都可访问文件和页面；private——仅文件可见，他人看不到页面；public——公开列出）、title（90 个字符）和 description（500 个字符）。新上传的内容会返回一个一次性 delete_url。

get_upload

需要提供 id。返回该上传内容的链接、缩略图、大小、可见性、标题和描述。

update_upload

需要提供 id，以及 visibility、title、description 中的任意项。只会修改你传入的内容；空字符串会清除标题或描述。

list_uploads

可选的 page（默认为 1，每页 50 项）。按上传时间从新到旧返回你的上传内容。

delete_upload

需要提供 id（来自 upload_image/list_uploads）。永久删除该上传内容。

说明

• 此服务始终只以与 YIS_API_KEY 关联的账户身份操作——已连接的 Agent 无法以其他账户身份操作。
• API 错误（密钥无效、触发速率限制、文件被审核拒绝等）会作为工具错误结果返回，并附带 API 自身的错误信息，而不会导致工具调用崩溃。
• 本服务采用小巧、独立的客户端实现，而不依赖单独的 yourimageshare npm 包，因此本服务的发布不会与该包绑定。

许可证

MIT

Support

yourimageshare.com/contact