MemeStack MCP

MemeStack MCP

为 MemeStack 提供托管的 Model Context Protocol 服务——这是一个用于搜索表情包、信息图表、图表、屏幕截图和示意图的视觉搜索引擎。可按含义、图像中印刷的 OCR 文本或视觉相似度查找图像。由 AI 添加说明文字，并通过 Lightning 排序。公开、无需身份验证、无需注册——读取免费，但有每日配额；生成按次付费。

https://mcp.memestack.ai/mcp

每个列表响应都会返回引用块（markdown / HTML / 纯文本），可直接粘贴并注明出处。图像字节由 https://api.memestack.ai/v1/images/{id}/{thumbnail|canonical|social-card} 提供——可直接嵌入。

---

安装

这是一个托管服务。无需克隆、构建或配置本地环境。将任何支持 MCP 的客户端指向该端点即可。以下每个代码片段都已于 2026-10-11 根据相应客户端自己的文档进行核对；当前列表及各客户端文档链接见 memestack.ai/mcp-server。

Claude Code

claude mcp add --transport http memestack https://mcp.memestack.ai/mcp

也可以在项目的 .mcp.json 中配置——远程服务需要 "type": "http"：

{
  "mcpServers": {
    "memestack": {
      "type": "http",
      "url": "https://mcp.memestack.ai/mcp"
    }
  }
}

或作为插件使用（添加一项技能）

此仓库也是一个 Claude Code 插件市场。该插件会安装同一服务，以及一项 find-image 技能，告诉 Claude 哪个工具可以响应哪种请求，并要求保留引用：

/plugin marketplace add Ed-Relight/memestack-mcp
/plugin install memestack@memestack

在 shell 中运行：claude plugin marketplace add Ed-Relight/memestack-mcp，然后运行 claude plugin install memestack@memestack。如果你还使用 claude.ai 连接器，Claude Code 会将工具列出两次（每个服务各一份）；使用其中任意一个即可。

Claude（claude.ai 和 Claude Desktop）

从 Connectors Directory 添加 MemeStack，或将其作为自定义连接器添加：Customize → Connectors → + Add → Add custom connector，并使用目录端点 https://mcp.memestack.ai/mcp/directory（见下文的聊天应用）。所有套餐均可使用；Free 账户可以添加一个自定义连接器。

Claude Desktop 的 claude_desktop_config.json 仅接受本地服务。要在其中使用完整的 /mcp 端点，请通过 mcp-remote 建立桥接：

{
  "mcpServers": {
    "memestack": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.memestack.ai/mcp"]
    }
  }
}

Cursor

单击即可打开 Cursor 的安装提示（Cursor 安装链接）。此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json + mcp.json，包含 find-image 技能）。也可以编辑 ~/.cursor/mcp.json（或项目级 .cursor/mcp.json）：

{
  "mcpServers": {
    "memestack": { "url": "https://mcp.memestack.ai/mcp" }
  }
}

VS Code（GitHub Copilot）

单击 memestack.ai/mcp-server 上的 Add to VS Code 链接即可（这是一个 vscode:mcp/install 链接，GitHub 不会渲染该链接）。也可以在工作区根目录使用 .mcp.json，或使用 ~/.copilot/mcp-config.json 为所有工作区配置（较旧的 .vscode/mcp.json 配置中 "servers" 仍会加载，但 VS Code 现在将其标记为已弃用）：

{
  "mcpServers": {
    "memestack": {
      "type": "http",
      "url": "https://mcp.memestack.ai/mcp"
    }
  }
}

Devin Desktop（原名 Windsurf）

devin mcp add memestack https://mcp.memestack.ai/mcp

Gemini CLI

gemini extensions install https://github.com/Ed-Relight/memestack-mcp

扩展清单（gemini-extension.json）会通过 Streamable HTTP（httpUrl）将 Gemini CLI 指向托管端点。不使用扩展时：

gemini mcp add --transport http memestack https://mcp.memestack.ai/mcp

这会在项目中写入 .gemini/settings.json；添加 --scope user 可写入 ~/.gemini/settings.json。

OpenAI Codex CLI

codex mcp add memestack --url https://mcp.memestack.ai/mcp

也可以在 ~/.codex/config.toml 中配置（与 ChatGPT 桌面应用和 Codex IDE 扩展共用）：

[mcp_servers.memestack]
url = "https://mcp.memestack.ai/mcp"

Cline

在 Cline 的 MCP 设置（cline_mcp_settings.json）中，使用驼峰命名的 streamableHttp 类型添加服务——否则 Cline 会回退到 SSE，端点会返回 405：

{
  "mcpServers": {
    "memestack": {
      "type": "streamableHttp",
      "url": "https://mcp.memestack.ai/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Remote Servers 选项卡也采用相同设置（Transport 为 “Streamable HTTP”），Cline CLI 也是如此：

cline mcp add memestack https://mcp.memestack.ai/mcp --transport http --yes

Zed

在 Zed 设置（zed: open settings file）中，或通过 Settings → AI → MCP Servers → Add Remote Server：

{
  "context_servers": {
    "memestack": { "url": "https://mcp.memestack.ai/mcp" }
  }
}

Goose

运行 goose configure → Add Extension → Remote Extension (Streamable HTTP)，或在 ~/.config/goose/config.yaml 中配置（Windows：%APPDATA%\Block\goose\config\config.yaml）：

extensions:
  memestack:
    type: streamable_http
    name: memestack
    enabled: true
    uri: "https://mcp.memestack.ai/mcp"
    headers: {}
    env_keys: []
    envs: {}
    timeout: 300

LM Studio

LM Studio 0.3.17 或更高版本：Program 选项卡 → Install → 编辑 mcp.json：

{
  "mcpServers": {
    "memestack": { "url": "https://mcp.memestack.ai/mcp" }
  }
}

Continue

创建 .continue/mcpServers/memestack.yaml（MCP 工具可在 Agent 模式下使用）：

name: MemeStack
version: 0.0.1
schema: v1
mcpServers:
  - name: memestack
    type: streamable-http
    url: https://mcp.memestack.ai/mcp

不支持远程 MCP 的客户端

使用 mcp-remote桥接端点：

{
  "mcpServers": {
    "memestack": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.memestack.ai/mcp"]
    }
  }
}

原始 JSON-RPC（任意 HTTP 客户端）

curl -X POST https://mcp.memestack.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

initialize、tools/call、prompts/list、prompts/get、resources/list、resources/read 使用相同端点。协议版本：2025-06-18。

聊天应用（目录端点）

聊天应用使用专为其连接器目录构建的第二个端点：

https://mcp.memestack.ai/mcp/directory

该端点列出 18 个读取工具（所有读取工具，但不包括 get_leaderboard；仍可通过名称调用该工具）——没有付费工具、没有付款请求、没有每日配额——且结果中不会包含被归类为争议内容的图片（该端点没有 include_controversial 参数；按 ID 查询此类图片时会返回“未找到”）。资源和引用与 /mcp 上的相同；该端点的 prompts/list 显示五个提示词——除 top_zapped 之外的所有提示词；它不会列出该提示词对应的工具（仍可通过名称调用 prompts/get）。将其 URL 作为自定义连接器添加（Streamable HTTP，无需身份验证）。工具调用按分钟限流；超出限制时，调用会返回“Too many requests from this client”——等待一分钟后重试。在 ChatGPT（以及其他 MCP Apps 宿主）中，图片结果会以图片卡片轮播的形式显示。

各应用的设置位置（检查日期：2026-10-11）：

• Claude — 参见上文。
• ChatGPT（网页）— Plugins → + → Add custom MCP server → Server URL → Create as a plugin。适用于 Business 和 Enterprise/Edu；Pro 用户可在开发者模式下使用读取/获取权限连接。
• Mistral Le Chat — Connectors → + Add Connector → Custom MCP Connector。适用于管理员（Free、Pro 和 Student 方案的账户所有者）。
• Perplexity — Account settings → Connectors → + Custom connector → Remote，传输方式选择 Streamable HTTP。适用于 Pro、Max 和 Enterprise。
• Microsoft Copilot Studio — Agent 的 Tools 页面 → Add a tool → New tool → Model Context Protocol，身份验证选择 None。需要启用生成式编排（Copilot Studio for Teams 方案不支持）。

---

暴露的内容

• 21 个工具，其中 tools/list 默认显示一组核心工具——search_images、search_text_in_image、search_charts、find_meme_for_text、reverse_image_search、find_similar、get_image、cite_image，以及两个付费工具；仍可通过名称调用所有工具。总计：19 个免费读取工具（其中 8 个有每日配额，超出后每次调用收费不到 1 美分——参见定价与付款），2 个始终收费的工具（generate_meme、submit_image）——完整目录：docs/tools.md
• 6 个提示词——预设工作流（按主题搜索、最热门的 zapped 内容、引用 meme、按氛围寻找 meme、研究 meme 演变、趋势）。只有在某个提示词使用的所有工具都已列出的情况下，prompts/list 才会显示该提示词，因此默认显示三个——search_memes、cite_this_meme、find_a_meme_for_vibe；另外三个仍可通过名称调用 prompts/get：docs/prompts.md
• 4 个资源——署名指南、标签分类体系、近期上传动态，以及 memestack://top/{period} 模板（热门 zapped 图片）：docs/resources.md

工具一览

发现与搜索：

• search_images — 语义与关键词合并搜索
• search_charts — 搜索带有已存储来源元数据（数据集、引用、单位、地区、展示时段）的图表/信息图表；并非覆盖所有图表——search_images 的图表覆盖范围更广。publisher_only: true（此处及 search_images 中均可使用）仅保留从 Our World in Data、USDA ERS、Eurostat 或 EEA 导入的图表
• search_text_in_image — 仅 OCR 搜索（查找包含特定引文/文本的截图）
• find_meme_for_text — 为写作和社交内容匹配氛围契合的表情包（仅搜索标记为表情包的图片，因此结果可能为空；search_images 涵盖所有类型的图片）
• reverse_image_search — 基于 phash 的“查找此图片”搜索（接受 HTTPS 或 data: URL）
• find_similar / find_related — 查找与已知图片相似/相关的图片（视觉 phash / 语义嵌入）
• browse_images、browse_by_tag、browse_by_category、list_categories
• popular_tags、tag_autocomplete、get_tag_profile
• get_image、get_user_profile、get_leaderboard、get_meme_variants

诚实搜索结果（正在逐步推出——仅当服务端开启诚实搜索开关时，才会为结果添加标签）：当结果包含 match 时，search_images、search_charts、search_text_in_image 和 find_meme_for_text 会为每项结果标注 "strong"（MemeStack 有证据表明它符合你的查询）或 "closest"（这是它能找到的最接近结果）。强匹配结果优先显示；最接近结果数量有限，并会在文本视图中标记为 [closest match]。如果没有强匹配，第一页开头会附带 note；has_more 表示是否还有下一页（total 仅统计强匹配结果）。未添加标签时，不会有 match、note 或 has_more：结果页的数量少于 limit 时，即表示已到最后一页。添加标签后，match_quality 会概述搜索结果：strong（存在强匹配）、closest_only（所有结果都只是最接近的猜测——请勿将其作为答案呈现）或 none。

重复使用权利：每张图片都包含 rights，其中有 source（publisher / creator / community）、许可及其 URL、署名行（attribution）以及 commercial_use（yes / no / unknown；unknown 绝不代表猜测——Our World in Data 图表可能会依据第三方条款展示数据，MemeStack 不会为社区上传内容授予许可）。citation 说明如何标注图片来源；rights 则说明是否允许重复使用。cite_image 会同时提供二者。

默认安全：所有搜索和浏览工具都会排除被 MemeStack 归类为争议性内容的图片（党派攻击类表情包、辱称、黑色幽默——这些内容存在于素材库中，但不会作为默认结果）。在 search_images、search_charts、search_text_in_image、find_meme_for_text、reverse_image_search、find_similar、find_related、browse_images 或 browse_by_tag 中传入 include_controversial: true，即可将其纳入结果；每项此类结果都会在文本视图中标记为 [controversial]，并在结构化载荷中包含 controversial: true。按 ID 查询的工具（get_image、get_meme_variants、cite_image）始终会返回结果，并附带该标记。REST 等效用法是在浏览端点中使用 ?content=all（默认值为 content=safe；任何其他值都会返回 400 INVALID_CONTENT）。

署名：

• cite_image — 为一个或多个图片 ID 生成标准的 Markdown/HTML/纯文本署名块

付费（Agent 支付通道——按调用付费，无需账户）：

• generate_meme — 通过 Grok Imagine 生成 AI 图片。标准版 $0.08 / 优质版 $0.20，以 sats 或 USDC 支付。返回托管、自动添加标签并由 CDN 提供服务的图片 URL。
• submit_image — 通过 URL 提交图片，进入审核队列。每次提交 $0.10，以 sats 或 USDC 支付，始终收费，不设免费额度。审核拒绝（重复/nsfw/垃圾内容/低质量）不予退款——该费用用于防止垃圾提交；已接受的图片须经人工审核后才会发布。

---

引文已内置

每个列表响应都会包含一个 citations_combined 区块，以三种格式（markdown / HTML / 纯文本）呈现完整引文集，并为每张单独的图片提供一个 citation。不同来源的规则有所不同：OWID 图片需注明 Our World in Data 的 CC-BY 4.0 署名；Imgflip 模板需注明 Imgflip；直接上传的图片需注明上传者的显示名称和 MemeStack 页面 URL；Verified Creator 上传的图片会将创作者姓名直接链接到其个人网站（必须署名）。

每个会话请读取一次 memestack://attribution-guide，了解许可模式和各来源的规则。另请参阅 docs/resources.md。

---

定价与付款

读取免费，每日配额充足；生成按次付费。所有价格均以美元固定，并按当前 BTC/USD 汇率以 sats 支付，或使用 USDC 支付。无需账户，无需 API 密钥——付款本身就是身份验证，支持两种支付通道：

• x402（Base 上的 USDC）——标准的 x402/error + x402/payment _meta 流程；可直接与 Cloudflare Agents SDK 的 withX402Client 配合使用。请注意：该 SDK 的默认 maxPaymentValue 为 $0.10，正好足够支付 submit_image（$0.10）；若要使用 generate_meme 的质量模式（$0.20），需调高该值。
• L402（Lightning sats，按当前 BTC/USD 汇率折算）——在 REST 中使用标准的 WWW-Authenticate: L402 macaroon="…", invoice="…" 质询；使用 Authorization: L402 <macaroon>:<preimage> 重试。通过 MCP 时，实验性的 l402/payment _meta 扩展会携带相同的支付凭证。

工具组	免费配额	超出配额后的价格
搜索与浏览工具（search_images、search_charts、browse_*、find_meme_for_text、search_text_in_image）	200 次调用/天/IP	$0.005/次调用
reverse_image_search	10 次调用/天/IP	$0.02/次调用
generate_meme	始终付费	标准模式 $0.08 / 质量模式 $0.20
submit_image	始终付费	$0.10/次提交
其他所有内容（get_image、cite_image、标签、类别、排行榜、资源、提示词）	不限量，免费	—

当前每项价格对应的 sats 数量：GET api.memestack.ai/v1/prices。付费 REST 对应接口（价格相同，采用标准双标头 402）：POST api.memestack.ai/v1/agent/generate、POST api.memestack.ai/v1/agent/reverse-search 和 POST api.memestack.ai/v1/agent/submit——详见 OpenAPI 规范。

每笔付款最多交付一个结果——如果调用失败或在生成过程中超时，请使用同一份支付凭证重试以继续处理；同一笔付款绝不会被重复收费。

通过 submit_image 提交的图片会进入审核队列，而不会直接出现在公共图库中——如果审核拒绝该提交（重复、nsfw、垃圾内容或质量低下），恕不退款，因为费用购买的正是审核机会。

---

发现入口

MemeStack 除 MCP 之外向 AI Agent 提供的发现入口：

入口	URL	用途
llms.txt	memestack.ai/llms.txt	简洁、便于人类阅读的摘要及端点链接
ai-plugin.json	memestack.ai/.well-known/ai-plugin.json	ChatGPT 插件清单
OpenAPI 3.1	api.memestack.ai/openapi.json	MCP 封装的 REST API
Apex MCP 镜像	memestack.ai/mcp	位于 apex 的同一 MCP 端点（供简单扫描器使用）
MCP 服务卡片	mcp.memestack.ai/mcp/server-card	SEP-2127 服务卡片（application/mcp-server-card+json）；镜像位于 memestack.ai/mcp/server-card 和 memestack.ai/.well-known/mcp/server-card.json
ARD 清单	memestack.ai/.well-known/ard.json（别名 /.well-known/ai-catalog.json）	指向服务卡片的 Agentic Resource Discovery 条目
API 目录	memestack.ai/.well-known/api-catalog	RFC 9727 链接集：包含 REST API 和 MCP 服务的描述、文档及健康检查端点
Agent Skill	memestack.ai/.well-known/agent-skills/memestack/SKILL.md	agentskills.io 技能——介绍何时使用 MemeStack、REST 快速入门、工具费用和引用规则；索引位于 /.well-known/agent-skills/index.json
x402 Bazaar	api.cdp.coinbase.com/platform/v2/x402/discovery/resources	Coinbase 的 x402 发现目录——付费 REST 端点（/v1/agent/*）和 MCP 工具 generate_meme/submit_image，附带请求体架构、示例和价格
oEmbed	api.memestack.ai/v1/oembed	适用于图库 URL 的富类型 oEmbed——包含带有经 MemeStack 提供信用链接的 html 嵌入代码片段
Sitemap	memestack.ai/sitemap.xml	包含图像、页面和用户子站点地图的站点地图索引

---

源码

MCP 服务运行在 Cloudflare Workers 上，并代理公开的 MemeStack REST API（api.memestack.ai）。该服务的源码属于更大的 MemeStack 代码库，目前尚未公开镜像。本仓库提供面向公众的文档、安装代码片段和工具目录，方便目录提交者和集成方链接到稳定、可浏览的入口。

如果你想复刻其协议行为并自托管类似的图库，REST API 已有文档说明，可作为任何 MCP 风格封装的充分后端。

本仓库中的 Dockerfile 是一个轻量代理——它使用 mcp-remote 将 stdio MCP 桥接到托管的 HTTP 端点；其存在目的仅是让要求基于 Dockerfile 进行内省的 MCP 目录（Glama 等）能够验证在线工具/提示词/资源。最终用户应按照上文的 安装 部分，直接连接到 mcp.memestack.ai/mcp；Docker 镜像不包含源码。

---

许可证

MIT——适用于本仓库中的代码片段和文档。托管的 MemeStack 服务另受 memestack.ai/terms 约束。图像权利仍归其所有者所有：只有开放数据发布者的图表（CC BY 4.0 或美国公有领域）和 Verified Creator 的作品附有许可证条款，详见 memestack.ai/license。MemeStack 不授予任何其他图像的使用许可；citation 块仅用于标注来源，并不代表允许再利用。