Bitview

bitview_mcp

bitview_mcp は、Bitview REST API 用の薄型でステートレスな読み取り専用 MCP アダプターです。MCP で公開される OpenAPI 操作を生成されたツールとして公開し、すべてのツール呼び出しを設定されたパブリック REST オリジンに GET リクエストとして転送します。

公式パブリックエンドポイントは mcp.bitview.space です。ステートレスで読み取り専用のため、認証は不要です。

現在のソースからビルドされたサーバーは、インスタンスのランディングページ、/privacy、/terms、/support、/logo.png も提供します。アイコンはバイナリに埋め込まれ、MCP のディスカバリメタデータで通知されます。これらのインスタンス固有のルートは MCP プロトコルとは別のものであり、古いバージョンがデプロイされている場合は利用できないことがあります。

キャッシュモデル

bitview_mcp は API レスポンスをキャッシュせず、MCP セッションも保持しません。アップストリームへの GET リクエストが既存の Cloudflare キャッシュを利用できるよう、Cloudflare を経由するパブリック REST オリジンを指定してください。

MCP client -> bitview_mcp -> Cloudflare-cached REST API -> Bitview server

Cloudflare で MCP エンドポイントをキャッシュする必要はありません。MCP カタログ TTL は、静的なディスカバリメタデータとツール一覧メタデータに対する、標準的なクライアント側のキャッシュヒントにすぎません。

実行

ワークスペースから実行します。

cargo run -p bitview_mcp -- \
  --api https://bitview.space \
  --url https://mcp.bitview.space/ \
  --name Bitview

または、インストール済みのバイナリを実行します。

bitview_mcp \
  --api https://api.example.com \
  --url https://mcp.example.com/ \
  --name "Example Node"

次の 3 つのオプションはすべて必須です。

• --api はアップストリームの Bitview REST オリジンです。ホスト名だけが指定された場合は、まず HTTPS を試し、HTTPS がトランスポート層で失敗した場合にのみ HTTP で再試行します。
• --url は、このサーバーのパブリック MCP URL です。絶対 HTTP(S) オリジンである必要があります。
• --name は、ランディングページと MCP ディスカバリメタデータに表示される、人が読めるインスタンス名です。

ローカル開発の場合：

bitview_mcp \
  --api http://127.0.0.1:3110 \
  --url http://127.0.0.1:3111/ \
  --name "Local Bitview"

デフォルトの Streamable HTTP エンドポイントは http://127.0.0.1:3111/ です。このポートを利用できない場合、サーバーは 3211 までの各ポートを順に試します。サーバーは MCP プロトコルバージョン 2026-07-28 をサポートしています。

どちらの URL も、パス、クエリ、認証情報を含まないオリジンである必要があります。パブリック URL には末尾のスラッシュが追加されます。

生成されたカタログ

ツールカタログは正規の OpenAPI ドキュメントから bitview_bindgen によって生成され、コンパイル時に generated/manifest.json からバイナリに埋め込まれます。生成されたマニフェストを手動で編集しないでください。API を変更した後は、次を実行してください。

cargo run -p bitviewd --example bindgen --features bindgen