Bitview

bitview_mcp

bitview_mcp 是一个轻量、无状态、只读的 MCP 适配器，用于连接 Bitview REST API。它将 MCP 可见的 OpenAPI 操作公开为生成的工具，并将每次工具调用转发为发往配置的公共 REST 源站的 GET 请求。

官方公共端点为 mcp.bitview.space。它无状态、只读，且无需身份验证。

根据当前源码构建的服务还会提供实例落地页、/privacy、/terms、/support 和 /logo.png。图标嵌入在二进制文件中，并在 MCP 发现元数据中公布。这些实例本地路由独立于 MCP 协议，在较旧的已部署版本中可能不可用。

缓存模型

bitview_mcp 不会缓存 API 响应或保留 MCP 会话。将其指向由 Cloudflare 提供前置服务的公共 REST 源站，使其上游 GET 请求使用现有的 Cloudflare 缓存：

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"

以下三个选项均为必需：

• --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 会规范化为以斜杠结尾。

生成的目录

工具目录由 bitview_bindgen 根据规范 OpenAPI 文档生成，并在编译时从 generated/manifest.json 嵌入二进制文件。请勿手动编辑生成的清单；更改 API 后，请运行：

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