Zipp

Zipp MCP

AI アシスタント向けの多言語暗号資産ニュース — 編集者による要約、 センチメントラベル（BULLISH／NEUTRAL／BEARISH）、重要度スコア （0–100）、各記事の元の配信元の明記。

このリポジトリには、公開リスティング用マニフェストと zipp-mcp Python パッケージが含まれています。正規の Zipp MCP サーバーは https://zippfeed.com/mcp/ でホストされています。ほとんどのクライアントは この URL に直接接続してください。PyPI／Docker パッケージは、標準入出力のみのデスクトップクライアントや 制限されたネットワークなど、直接接続できない場合や、自己完結型のインストールを 使用したい場合のためのものです。

• 🌐 ウェブサイト：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 日目のフォローアップ）

セルフホスト

インストール方法は 3 通りあります。どの方法でも同じプロトコルを使用し、 同じ上流 API を呼び出します。適切な方法はクライアントによって異なります。

uvx — インストール不要、1 つのコマンド

ローカルのサブプロセスの起動に対応した、標準入出力を使う MCP クライアント（Claude Desktop、Cursor の標準入出力モード、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

サーバー（Railway、Fly、Render）で Streamable HTTP トランスポートを使う場合：

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 はニュースの大量配信に編集レイヤーを加えます。

シグナル	説明
センチメント	各記事に BULLISH／NEUTRAL／BEARISH のラベルを付与（編集上の評価であり、助言ではありません）
重要度	0–100 のスコア。≥ 75 が速報のしきい値です
多言語対応	8 言語に対応し、各言語に適した品質の要約を提供（自動翻訳ではありません）
出典情報	すべての記事に元の配信元の名前と URL を常に記載
分類体系	7 カテゴリー × 5 サブカテゴリー ＝ 35 のサブ分類。スラッグは安定しています

クイックスタート

Zipp は https://zippfeed.com/mcp/ で Streamable HTTP を提供しています。認証もインストールも不要です。以下に、主要な MCP 対応クライアント向けのコピー＆ペーストできる設定と、エンドポイントのスモークテストを行う 2 つの方法を示します。

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）

1 行のコマンドです。ユーザースコープに Zipp を登録するため、すべてのプロジェクトで使えます：

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

claude mcp list で確認します。

Claude.ai Web（コネクタ）

Settings → Connectors → カスタムコネクタを追加 → URL: https://zippfeed.com/mcp/ → 認証不要。

ChatGPT（カスタムコネクタ）

Settings → Connectors → 追加 → Custom connector → URL: https://zippfeed.com/mcp/ → 認証：なし。

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 サーバー → 設定を編集し、cline_mcp_settings.json に Zipp を追加します：

{
  "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 コネクタはベータ版です。正式リリースまでは、以下のヘッダーを渡してください：

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"}}}'

期待される結果：serverInfo.name = "Zipp" で、サーバーが tools、resources、prompts の各機能を提供する JSON-RPC initialize の結果です。

対話型 UI を使うには、公式の MCP Inspector を実行します：

npx @modelcontextprotocol/inspector

開いたブラウザータブで、トランスポートとして Streamable HTTP を選び、https://zippfeed.com/mcp/ を貼り付けて 接続をクリックします。その後、ツール／リソース／プロンプトの各タブを使って、サーバーを最初から最後まで試します。

ツール

ツール	シグネチャ	戻り値
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 サーバーレジストリに 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/* は MCP エンドポイントへの案内を含む 410 Gone を返します。AI エージェントとの連携には MCP を、長文コンテンツの閲覧には上記の RSS または JSON Feed をご利用ください。

法的事項

• 編集方針
• プライバシー
• 利用規約
• お問い合わせ：[email protected]

ライセンス

このリポジトリ（README、マニフェスト、サンプルクライアント）は、MIT License に基づいて公開されています。対象は公開ドキュメントと掲載用マニフェストのみです。MCP サーバーの実装自体はプロプライエタリであり、Zipp がホストしています。