Zipp

Zipp MCP

面向 AI 助手的多语言加密货币新闻——编辑摘要、 情绪标签（BULLISH / NEUTRAL / BEARISH）、重要性评分 （0–100），并为每条新闻标注其原始发布方。

此仓库托管公开列表清单和 zipp-mcp Python 包。Zipp MCP 的规范服务托管于 https://zippfeed.com/mcp/——大多数客户端应直接连接 此 URL。PyPI / Docker 包适用于无法直接连接的情况： 仅支持 stdio 的桌面客户端、受限网络， 或任何需要独立安装的场景。

• 🌐 网站：zippfeed.com
• 🔌 MCP 端点：https://zippfeed.com/mcp/
• 📡 传输方式：Streamable HTTP（MCP 规范 2025-06-18）
• 🔓 身份验证：无——公开服务，在 Cloudflare 边缘限流
• 📰 覆盖范围：涵盖 8 种语言的加密货币 / 区块链 / Web3 新闻
• ✍️ 编辑内容：每条内容均包含情绪、重要性和来源归属信息
• 📦 PyPI：uvx zipp-mcp · Docker：ghcr.io/deficlow/zipp-mcp（第 3 天后续）

自托管

有三种安装方式。它们使用相同的协议并调用 相同的上游 API；选择哪种方式取决于客户端。

uvx — 无需安装，一条命令

适用于 stdio MCP 客户端（Claude Desktop、Cursor 的 stdio 模式、Cline、 Zed 等），这些客户端倾向于启动本地子进程：

uvx zipp-mcp

Claude Desktop 配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "zipp": {
      "command": "uvx",
      "args": ["zipp-mcp"]
    }
  }
}

pip install — 用于嵌入式使用

pip install zipp-mcp
zipp-mcp --transport stdio

或者在自己的代码中直接导入客户端：

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 — 用于托管 / 沙盒环境

docker run -i --rm ghcr.io/deficlow/zipp-mcp

在服务器上使用 Streamable HTTP 传输（Railway、Fly、Render）：

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–120s）
MCP_HOST	127.0.0.1	HTTP/SSE 传输的绑定主机（在容器中设为 0.0.0.0）
MCP_PORT	8080	绑定端口；也别名为 Railway/Fly/Render/Heroku 使用的 PORT

此包为只读包——无需进行身份验证；上游 API 是公开的， 并在 Cloudflare 边缘限流。

为什么选择 Zipp？

大多数新闻连接器只是纯聚合器，只会向模型提供原始 标题列表。Zipp 在信息流之上增加了编辑层：

信号	作用
情绪	为每条新闻标注 BULLISH / NEUTRAL / BEARISH（编辑观点，并非建议）
重要性	0–100 分；≥ 75 为突发新闻阈值
多语言	支持 8 种语言，提供原生质量的摘要（并非自动翻译）
来源归属	每条内容均附原始发布方名称 + URL
分类体系	7 个类别 × 5 个子类别 = 35 个子类，使用稳定的 slug

快速开始

Zipp 通过 https://zippfeed.com/mcp/ 提供 Streamable HTTP 服务——无需身份验证，也无需安装。以下是主要 MCP 客户端的复制粘贴配置，以及两种快速测试端点的方法。

Claude Desktop

添加到 claude_desktop_config.json（macOS： ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "zipp": {
      "type": "http",
      "url": "https://zippfeed.com/mcp/"
    }
  }
}

重启 Claude Desktop。你应该会在工具列表中看到 Zipp，并可以询问诸如 “目前加密货币领域有什么问题？” 或 “用土耳其语搜索 Zipp 上有关比特币 ETF 资金流入的内容。” 这样的问题。

Claude Code（CLI）

一行命令——在用户级别注册 Zipp，这样所有项目都能使用它：

claude mcp add --scope user --transport http zipp https://zippfeed.com/mcp/

使用 claude mcp list 验证。

Claude.ai 网页版（连接器）

Settings → Connectors → Add custom connector → URL：https://zippfeed.com/mcp/ → 无需身份验证。

ChatGPT（自定义连接器）

Settings → Connectors → Add → Custom connector → URL：https://zippfeed.com/mcp/ → 身份验证：None。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "zipp": {
      "url": "https://zippfeed.com/mcp/"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "zipp": {
      "serverUrl": "https://zippfeed.com/mcp/"
    }
  }
}

Cline（VS Code 扩展）

打开 Cline 面板 → MCP Servers → Edit Configuration，然后 将 Zipp 添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "zipp": {
      "url": "https://zippfeed.com/mcp/",
      "type": "streamableHttp"
    }
  }
}

Zed

~/.config/zed/settings.json——Zed 的 context_servers 接口目前仅支持 stdio，因此请使用 mcp-remote 桥接：

{
  "context_servers": {
    "zipp": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://zippfeed.com/mcp/"]
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "zipp": {
      "httpUrl": "https://zippfeed.com/mcp/"
    }
  }
}

OpenAI Responses API

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 连接器目前处于 Beta 阶段——在正式发布前，请传递以下标头：

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)

快速测试

在终端中验证服务——无需客户端：

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 功能。

如需交互式界面，请运行官方 MCP Inspector：

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?)	过去 24 小时内重要性 ≥ 75 的报道
get_featured	(lang?, limit?)	编辑精选内容
get_post	(slug_or_id, lang?)	完整文章正文 + 所有分类 + 主题标签
list_categories	(lang?)	7 × 5 分类体系（35 个叶子分类）

lang 默认为 en-US。完整列表请参阅下文的语言。

示例响应

get_latest(lang="en-US", limit=1) 返回的结构：

{
  "items": [
    {
      "id": 1234,
      "slug": "bitcoin-etf-inflows-500m",
      "url": "https://zippfeed.com/en-US/a/bitcoin-etf-inflows-500m",
      "title": "Bitcoin ETF inflows hit $500M",
      "summary": "Spot Bitcoin ETFs absorbed $500M in net inflows…",
      "category": "markets-etfs",
      "sentiment": "BULLISH",
      "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 和原始发布方，例如：

来自 Zipp — 原文：CoinDesk

建议链接到原始 source.url。指向编辑摘要时，应使用 Zipp 自己的规范 URL（item.url）。

编辑方法

Zipp 的编辑流程——包括信息源选择、AI 辅助摘要、情绪与重要性评分以及人工审核——记录在 zippfeed.com/en-US/p/methodology。

情绪是编辑标注，并非投资建议。

相关发现渠道

Zipp 已发布到官方 MCP Server Registry，名称为 com.zippfeed/zipp——汇总该注册表的目录（Smithery、Glama、mcp.so、 PulseMCP 等）会自动收录。

如果你正在构建与 Zipp 相关的工具，以下端点也对外开放：

• /llms.txt — 便于 AI 发现的 URL 映射
• /sitemap.xml、/news_sitemap.xml、/image_sitemap.xml
• /rss.xml + /feed.json（按语言、类别和切片提供不同版本）

独立开发者 REST API 已于 2026-05-14 停用——现在 GET /developer/v1/* 会返回 410 Gone，并指向 MCP 端点。AI Agent 集成应使用 MCP；长篇内容阅读器应使用上述 RSS 或 JSON Feed 渠道。

法律信息

• 方法
• 隐私
• 条款
• 联系方式：[email protected]

许可证

本仓库——README、清单和示例客户端——根据 MIT 许可证发布。该许可证仅涵盖公开文档和目录清单；MCP 服务实现本身为专有内容，由 Zipp 托管。