zipp-mcp

# Zipp MCP > 面向 AI 助手的加密货币多语言新闻 — 编辑摘要、情绪标签（看涨 / 中立 / 看跌）、重要性评分（0-100）和每篇文章均注明原始发布者。 [](https://zippfeed.com/mcp/) [](https://registry.modelcontextprotocol.io/v0/servers?search=zipp) [](https://smithery.ai/servers/deficlow/zipp) [](https://modelcontextprotocol.io/) [](https://zippfeed.com/mcp/) [](#languages) [](LICENSE) 本仓库托管 **公共列表清单** 和 **`zipp-mcp` Python 包**。Zipp MCP 服务器的规范 URL 为 `https://zippfeed.com/mcp/` — 大多数客户端应直接连接到该 URL。PyPI / Docker 包适用于无法直接连接的场景：仅限标准输入的桌面客户端、受限网络或需要独立安装的场景。 - 🌐 网站：[zippfeed.com](https://zippfeed.com) - 🔌 MCP 端点：`https://zippfeed.com/mcp/` - 📡 传输：Streamable HTTP（MCP 规范 `2025-06-18`） - 🔓 认证：无 — 公共，Cloudflare 边缘限速 - 📰 覆盖范围：加密货币 / 区块链 / Web3，涵盖 8 种语言 - ✍️ 编辑：每项内容均带有情绪 + 重要性 + 来源归属 - 📦 PyPI：`uvx zipp-mcp` · Docker：`ghcr.io/deficlow/zipp-mcp` （第 3 天跟进） ## 自主部署 三种安装方式。所有方式均使用相同的协议，调用相同的上游 API；选择取决于客户端。 ### `uvx` — 无需安装，一条命令 适用于偏好启动本地子进程的标准输入 MCP 客户端（Claude Desktop，Cursor 的标准输入模式，Cline，Zed 等）： ```bash uvx zipp-mcp ``` Claude Desktop 配置（`claude_desktop_config.json`）： ```json { "mcpServers": { "zipp": { "command": "uvx", "args": ["zipp-mcp"] } } } ``` ### `pip install` — 嵌入式使用 ```bash pip install zipp-mcp zipp-mcp --transport stdio ``` 或在您自己的代码中直接导入客户端： ```python from zipp_mcp import ZippClient async with ZippClient() as zipp: payload = await zipp.search(query="bitcoin etf", lang="en-US", limit=5) for item in payload["items"]: print(item["title"], item["sentiment"], item["importance"]) ``` ### Docker — 用于托管 / 沙盒环境 ```bash docker run -i --rm ghcr.io/deficlow/zipp-mcp ``` 用于服务器（Railway，Fly，Render）的 Streamable HTTP 传输： ```bash docker run -p 8080:8080 -e MCP_HOST=0.0.0.0 \ ghcr.io/deficlow/zipp-mcp \ zipp-mcp --transport http ``` ### 配置 所有标志均可从环境变量中读取；所有内容均为可选。 | 环境变量 | 默认值 | 功能 | |------------------|------------------------|--------------| | `ZIPP_API_BASE` | `https://zippfeed.com` | 上游 Zipp 部署（暂存、镜像等） | | `ZIPP_API_TIMEOUT_S` | `30` | HTTP 客户端超时（1-120 秒） | | `MCP_HOST` | `127.0.0.1` | HTTP/SSE 传输的绑定主机（在容器中设置为 `0.0.0.0`） | | `MCP_PORT` | `8080` | 绑定端口；也作为 Railway/Fly/Render/Heroku 的 `PORT` 别名 | 该软件包是只读的 — 无需身份验证；上游 API 是公共的，在 Cloudflare 边缘限速。 ## 为什么选择 Zipp？ 大多数新闻连接器都是纯粹的聚合器，将原始标题列表交给模型。Zipp 在信息流上添加了 **编辑层**: | 信号 | 功能 | |--------------------|------------------------------------------------------------------------------| | **情绪** | 每个故事标记为 `看涨` / `中立` / `看跌`（编辑的，非建议） | | **重要性** | 0-100 分数；`≥ 75` 是 *突发* 阈值 | | **多语言** | 8 种语言，本地质量摘要（非自动翻译） | | **来源归属** | 每个项目均有原始发布者名称 + URL | | **分类法** | 7 类别 × 5 子叶 = 35 个叶子，稳定斜杠 | ## 快速开始 Zipp 在 `https://zippfeed.com/mcp/` 处使用 **Streamable HTTP** — 无需身份验证，无需安装。下面是主要支持 MCP 的客户端的复制粘贴配置，以及两种快速测试端点的方法。 ### Claude Desktop 添加到您的 `claude_desktop_config.json`（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`）： ```json { "mcpServers": { "zipp": { "type": "http", "url": "https://zippfeed.com/mcp/" } } } ``` 重启 Claude Desktop。您应该在工具列表中看到 Zipp，并能够询问诸如 *"加密货币现在有什么突破性的进展？"* 或 *"在土耳其搜索 Zipp 比特币 ETF 流入情况。"* ### Claude Code（CLI） 一句话 — 在用户范围内注册 Zipp，以便每个项目都能看到它： ```bash claude mcp add --scope user --transport http zipp https://zippfeed.com/mcp/ ``` 使用 `claude mcp list` 验证。 ### Claude.ai 网页（连接器） 设置 → 连接器 → **添加自定义连接器** → URL：`https://zippfeed.com/mcp/` → 无身份验证。 ### ChatGPT（自定义连接器） 设置 → 连接器 → **添加** → 自定义连接器 → URL：`https://zippfeed.com/mcp/` → 身份验证：**无**。 ### Cursor `~/.cursor/mcp.json`: ```json { "mcpServers": { "zipp": { "url": "https://zippfeed.com/mcp/" } } } ``` ### Windsurf `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "zipp": { "serverUrl": "https://zippfeed.com/mcp/" } } } ``` ### Cline（VS Code 扩展） 打开 Cline 面板 → **MCP 服务器** → **编辑配置**，然后在 `cline_mcp_settings.json` 中添加 Zipp： ```json { "mcpServers": { "zipp": { "url": "https://zippfeed.com/mcp/", "type": "streamableHttp" } } } ``` ### Zed `~/.config/zed/settings.json` — Zed 的 `context_servers` 接口目前仅限标准输入，因此使用 [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) 桥： ```json { "context_servers": { "zipp": { "command": { "path": "npx", "args": ["-y", "mcp-remote", "https://zippfeed.com/mcp/"] } } } } ``` ### Gemini CLI `~/.gemini/settings.json`: ```json { "mcpServers": { "zipp": { "httpUrl": "https://zippfeed.com/mcp/" } } } ``` ### OpenAI Responses API ```python from openai import OpenAI client = OpenAI() resp = client.responses.create( model="gpt-5", tools=[{ "type": "mcp", "server_label": "zipp", "server_url": "https://zippfeed.com/mcp/", "require_approval": "never", }], input="What's breaking in crypto right now? Cite the original publisher.", ) print(resp.output_text) ``` ### Anthropic Messages API MCP 连接器处于测试阶段 — 在其正式发布之前，请传递以下头部： ```python import anthropic client = anthropic.Anthropic() msg = client.messages.create( model="claude-opus-4-7", max_tokens=1024, mcp_servers=[{ "type": "url", "url": "https://zippfeed.com/mcp/", "name": "zipp", }], messages=[{"role": "user", "content": "What's breaking in crypto right now?"}], extra_headers={"anthropic-beta": "mcp-client-2025-04-04"}, ) print(msg.content) ``` ### 快速测试 在您的 shell 中验证服务器 — 无需客户端： ```bash curl -s -X POST "https://zippfeed.com/mcp/" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"1.0"}}}' ``` 预期结果：一个 JSON-RPC `initialize` 结果，其中 `serverInfo.name = "Zipp"`，并且服务器宣传 `tools`、`resources` 和 `prompts` 功能。 对于交互式 UI，请运行官方的 MCP Inspector： ```bash npx @modelcontextprotocol/inspector ``` 在打开的浏览器选项卡中，选择 **Streamable HTTP** 作为传输，粘贴 `https://zippfeed.com/mcp/`，点击 **Connect**，然后浏览 **Tools / Resources / Prompts** 选项卡以端到端测试服务器。 ## 工具 | 工具 | 签名 | 返回内容 | |-------------------|------------------------------------------------------------|--------------------------------------------------| | `search` | `(query, lang?, category?, limit?)` | 全文搜索，按时间倒序 | | `get_latest` | `(lang?, category?, limit?)` | 过去 24 小时的新闻 | | `get_breaking` | `(lang?, limit?)` | 重要性 ≥ 75 的新闻，过去 24 小时 | | `get_featured` | `(lang?, limit?)` | 编辑精选的新闻 | | `get_post` | `(slug_or_id, lang?)` | 完整的文章内容 + 所有分类 + 标签 | | `list_categories` | `(lang?)` | 7 × 5 分类法（35 个叶子） | `lang` 默认值为 `en-US`。有关完整列表，请参见下面的 [语言](#languages)。 ### 样本响应 `get_latest(lang="en-US", limit=1)` 返回形状： ```json { "items": [ { "id": 1234, "slug": "bitcoin-etf-inflows-500m", "url": "https://zippfeed.com/en-US/a/bitcoin-etf-inflows-500m", "title": "比特币 ETF 流入量达 5 億美元", "summary": "现货比特币 ETF 吸收了 5 億美元的净流入量…", "category": "markets-etfs", "sentiment": "看涨", "importance": 82, "published_at": "2026-05-13T15:08:55Z", "language": "en-US", "tags": ["markets-etfs", "btc", "etf"], "source": { "name": "CoinDesk", "url": "https://www.coindesk.com/..." }, "image_url": "https://cdn.zippfeed.com/images/rss/abc.jpg" } ] } ``` `get_post` 还返回完整的 `body`、`hashtags` 和扩展的 `categories[]` 数组。 ## 语言 | 代码 | 语言 | |----------|------------| | `en-US` | 英语 | | `tr-TR` | 土耳其语 | | `es-ES` | 西班牙语 | | `ru-RU` | 俄语 | | `pt-PT` | 葡萄牙语 | | `fr-FR` | 法语 | | `de-DE` | 德语 | | `it-IT` | 意大利语 | 每篇新闻都经过编辑摘要，支持的每种语言都有；情绪和重要性评分仅计算一次，并在所有语言变体中共用。 ## 来源政策 每篇 Zipp 新闻都在 `source` 字段中注明原始发布者。在使用 AI 回应中的 Zipp 内容时，**请同时注明 Zipp 和原始发布者**，例如： > *via Zipp — 原始：CoinDesk* 鼓励链接到原始 `source.url`。Zipp 自己的规范 URL（`item.url`）是正确的链接，指向编辑摘要。 ## 编辑方法论 Zipp 的编辑过程 — 饲料选择、AI 辅助摘要、情绪 + 重要性评分、人工审核 — 在 [zippfeed.com/en-US/p/methodology](https://zippfeed.com/en-US/p/methodology) 中有详细说明。 情绪是 **编辑标签**，而非投资建议。 ## 相关发现曲面 Zipp 发布到官方的 **MCP 服务器注册表**，网址为 [`com.zippfeed/zipp`](https://registry.modelcontextprotocol.io/v0/servers?search=zipp) — 目录会自动聚合注册表（Smithery、Glama、mcp.so、PulseMCP 等）。 如果您正在围绕 Zipp 构建工具，以下端点也是公开的： - [`/llms.txt`](https://zippfeed.com/llms.txt) — AI 可发现的 URL 映射 - [`/sitemap.xml`](https://zippfeed.com/sitemap.xml)，[`/news_sitemap.xml`](https://zippfeed.com/news_sitemap.xml)，[`/image_sitemap.xml`](https://zippfeed.com/image_sitemap.xml) - [`/rss.xml`](https://zippfeed.com/rss.xml) + [`/feed.json`](https://zippfeed.com/feed.json)（每种语言 + 每类别 + 每切片变体） 独立开发者 REST API 已于 2026-05-14 停用 — `GET /developer/v1/*` 现返回 `410 Gone`，并指向 MCP 端点。AI 代理集成应使用 MCP；长内容阅读器应使用上述 RSS 或 JSON Feed 接口。 ## 法律 - [方法论](https://zippfeed.com/en-US/p/methodology) - [隐私](https://zippfeed.com/en-US/p/privacy) - [条款](https://zippfeed.com/en-US/p/terms) - 联系方式：`hello@zippfeed.com` ## 许可证 本仓库 — README、清单和示例客户端 — 在 [MIT License](LICENSE) 下发布。它仅涵盖 **公共文档和列表清单**；MCP 服务器实现本身是专有的，由 Zipp 托管。