chatdata

chatdata

chatdata 是一个小型本地桥接工具，可连接托管的 HasData ChatGPT MCP 服务。向它提供提示词，ChatGPT 便会匿名作答：返回内容为 Markdown 文本，同时包含 ChatGPT 查询过的所有网络来源——每个来源的域名、页面标题、摘要、 发布日期和缩略图——以及答案中呈现的链接、ChatGPT 为本次交流生成的对话标题、作答所用的模型，以及是否使用了 网络搜索的标记。

每次调用都会开启全新对话，不会记住之前的内容。答案的语言 取决于提示词，因此请使用你希望获得答案的语言撰写提示词，或明确 指定语言。可选的时区会限定本次调用中“今天”或“本周”等词的含义， 这对询问近期事件的提示词尤为重要——这类提示词会让 ChatGPT 搜索网络并返回来源。

该桥接工具不会存储任何内容。它会在本地提供上游服务的工具列表， 内容与从在线端点捕获的完全一致，并将每次工具调用转发至上游， 原样返回结果。捕获到的接口仅包含一个只读查询： 其中没有写入、消息发送或支付工具。

工具

• hasdata_chatgpt_chat_getChatgptAnswer — 向 ChatGPT 发送一条 提示词，并返回答案及其来源。必需参数：prompt（问题或指令，最多 8000 个字符）。可选参数：timezone（IANA 时区名称，例如 America/Chicago 或 Europe/Berlin，用于设置当前日期和时间的 参照时区）。 返回 Markdown 格式的答案、查询过的网络来源、答案中的链接、 生成的对话标题、作答所用的模型，以及是否使用了网络搜索。

配置

• HASDATA_CHATGPT_MCP_URL（可选）— 覆盖 上游端点。默认值为 https://mcp.hasdata.com/mcp?apis=chatgpt。（此覆盖接口是本次重建 特有的标注重建内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用方自己的 HasData API 密钥。未设置时， 不会发送密钥标头。（标头名称和环境变量名称根据原始项目的注册表记录确定； 从此环境变量转发密钥属于标注重建内容——原始接口是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（协议版本 2025-03-26，clientInfo 名称为 chatdata）， 再发送 notifications/initialized 通知，然后发送 携带调用方原样参数的 tools/call 请求。上游通过 initialize 返回 Mcp-Session-Id 标头后，该值会随此会话的每个后续请求一起发送； 此会话会在进程运行期间持续复用。回复可能采用普通 JSON 或 服务器发送事件格式；两种格式均可读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态码、无法读取的响应，或 无法完成的请求——会作为 isError 结果返回，文本以 chatdata error: 开头（此错误呈现方式是本次重建特有的标注重建内容）。

CLI

该工具也可作为子命令使用，接受一个 JSON 参数字符串：

npx @reneturcios/chatdata hasdata_chatgpt_chat_getChatgptAnswer '{"prompt":"What happened in tech today?","timezone":"America/Chicago"}'
npx @reneturcios/chatdata --version

退出码：成功时为 0，结果带有 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/chatdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "chatdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/chatdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/chatdata
docker run --rm ghcr.io/cloudcorprecords/chatdata --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数 会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩接的 JSON-RPC 上游运行，不会发起任何实时网络调用。

许可证

MIT — 请参阅 LICENSE。