mcpField
Y

yourimageshare

本地服务
github.com/MediaShareORG文件与存储12 周前更新
代码仓库

关于 yourimageshare

yourimageshare 是面向 AI 编码 Agent 和其他 MCP 客户端的 YourImageShare 管理服务，可上传、查看、编辑和删除文件。文件可来自本地路径、内联数据或公开 URL。

主要功能

  1. 01通过路径、Base64 或 URL 上传文件
  2. 02查看和编辑上传信息
  3. 03列出并永久删除上传文件
  4. 04设置可见性和过期时间

适用场景

  1. 01在缺陷报告中添加截图链接
  2. 02在 Pull Request 中分享图片
  3. 03在支持沟通中提供图片

MCP 相关

通过 MCP 工具提供 YourImageShare 上传管理，包括上传、查看、列出、更新和删除。操作使用 `YIS_API_KEY` 关联的账户。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mediashareorg-yourimageshare": {
      "command": "npx",
      "args": [
        "-y",
        "yourimageshare-mcp"
      ],
      "env": {
        "YIS_API_KEY": "<YIS_API_KEY>"
      }
    }
  }
}
启动命令npx -y yourimageshare-mcp
需要配置的环境变量
YIS_API_KEY密钥Your YourImageShare API key. Get one at yourimageshare.com/my-account under the API tab.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmyourimageshare-mcp1.0.6

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pathstring否要上传的本地文件路径。
base64string否Base64 编码的文件内容。需要提供 `filename`。
filenamestring否要使用的文件名。与 `base64` 一起使用时必填；否则根据 `path` 推断。
expiresIninteger否在指定秒数后自动删除（60 到 2,592,000 秒，即 30 天）。省略则永久保存。

详细介绍

yourimageshare-mcp

npm version npm downloads smithery badge yourimageshare MCP server

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

安装 / 运行

无需安装——直接使用 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。