新时空 MCP 接入指南

所有参数均为可选。不传任何参数即返回全站最新文章。

search_articles

返回单段 Markdown 文本，不是 JSON。结构固定为「概要行 → 分隔线 → 逐条列表」：

📋 NewTimeSpace 资讯检索结果
关键词: 小米 | 分类: 全部 | 语言: zh-cn
日期: * ~ * | 排序: publish_time desc
第 1/15 页 · 本页 10 条 · 总计 143 条
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【1】恒生中国企业(02828.HK)盘中涨0.96%，恒指重回23000点… (ID: 1455411)
· 分类: ETF | 语言: zh-cn | 发布时间: 2026-10-23T13:45:24+08:00
· 作者: 沈博瀚 | 来源: 新时空 | 标签: ETF盘中异动,恒生中国企业,02828.HK
· 摘要: 恒生中国企业(02828.HK)10月23日盘中涨0.96%、报79.640港元…
· 链接: https://www.newtimespace.com/zh-cn/etf/1455411.html

──────────────────────────────

【2】…

• 概要行给出当前页码 / 总页数 / 本页条数 / 命中总数，可据此判断是否需要翻页。
• 列表中的 摘要 可能被截断（以 ...... 结尾），需要全文请调 get_article_detail。
• 发布时间 为带时区 ISO 8601（+08:00）。
• 链接 的路径随 language 变化（/zh-cn/、/zh-hk/、/en/）。
• 传 include_content: true 时，每条改为 📰 文章详情 [ID: …] 块并附 正文内容 (N 字，Markdown)。

get_article_detail

📰 文章详情 [ID: 1455411]
标题: 恒生中国企业(02828.HK)盘中涨0.96%，恒指重回23000点、国企指数午盘涨0.93%
分类: ETF | 语言: zh-cn | 时间: 2026-10-23T13:45:24+08:00
作者: 沈博瀚 | 来源: 新时空 | 标签: ETF盘中异动,恒生中国企业,02828.HK
链接: https://www.newtimespace.com/zh-cn/etf/1455411.html
────────────────────────────────────────
正文内容 (842 字，Markdown):
新时空讯：截至10月23日13时39分，恒生中国企业(02828.HK)上涨0.96%…

多篇时同样以 📰 文章详情 [ID: …] 分块连续返回。单篇正文约 800–2800 字。

标准两步式：先检索列表拿到 ID，再按需取正文，避免一次性拉取大量正文导致上下文溢出。

1. 检索：search_articles({"query":"小米","limit":10})。先看概要行的命中总数，判断关键词是否过宽（数万条）或过窄（0 条）。
2. 选目标：从列表挑 1–10 条最相关的 ID。
3. 取正文：get_article_detail({"article_ids":"1455411,1455409"})。
4. 整理输出：回答中保留 标题 + 发布时间 + 链接，便于溯源。

常见场景速查

服务端会区分两类失败：参数越界返回工具错误（isError: true），无结果返回空文案 + 提示。

如果所在环境无法添加 MCP Server，只要能发 POST 请求就能调用本服务。整个流程两步：先 initialize 拿会话 ID，再带着会话 ID 发 tools/call。

12.1 硬性要求（缺一不可）

12.2 最快方式：一条命令跑完

把两步合成一次执行，直接返回数据：

SID=$(curl -si --max-time 40 -X POST https://mcp.newtimespace.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-03-26","capabilities":{},"clientInfo":{"name":"web-agent","version":"1.0"}}}' \
  | grep -i '^mcp-session-id:' | tr -d '\r' | cut -d' ' -f2) && \
curl -s --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_articles","arguments":{"query":"小米","limit":2}}}'

它就是下面 12.3 的两步用 && 串起来的。若你的运行环境一次只能执行一条命令，直接用这条最省事。

12.3 拆开执行（两步分别调用）

第一步，握手并取出会话 ID：

SID=$(curl -si --max-time 40 -X POST https://mcp.newtimespace.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-03-26","capabilities":{},"clientInfo":{"name":"web-agent","version":"1.0"}}}' \
  | grep -i '^mcp-session-id:' | tr -d '\r' | cut -d' ' -f2)
echo "SID=$SID"

第二步，带着会话 ID 调用工具：

curl -s --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_articles","arguments":{"query":"小米","limit":3}}}'

响应是 SSE 流，正文包在 data: 行里：

event: message
data: {"result":{"content":[{"type":"text","text":"📋 NewTimeSpace 资讯检索结果n…"}],"isError":false},"jsonrpc":"2.0","id":2}

取用方法：取 data: 其后那一段 JSON，读 result.content[0].text，内容即第八节所示的 Markdown 文本。若 result.isError 为 true，text 里是错误说明而非数据。

12.4 用官方 SDK（Python）

若环境里有 Python 且能 pip install mcp，直接用官方 SDK 最省事，握手与会话管理它全包了：

import anyio
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client

async def main():
    async with streamable_http_client("https://mcp.newtimespace.com/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

            r = await session.call_tool("search_articles", {"query": "小米", "limit": 3})
            print(r.content[0].text)

anyio.run(main)

适配 mcp 2.x：只传 URL 即可连通，SDK 会自动把协议版本协商到 2025-11-25，两个工具及全部参数均正常。注意 2.x 起字段为蛇形命名（is_error、input_schema），照旧版教程写 isError 会报 AttributeError。

12.5 三个可以省掉的动作

• notifications/initialized 可以不发。规范建议发送，但本服务不强制——跳过它直接调 tools/call 完全正常。发了会返回 202 空响应，无副作用。
• MCP-Protocol-Version 请求头可以不带，带了值不对也不影响调用。
• 同一个会话 ID 可以连续复用多次调用，不必每次重新 initialize；若中途失效，重跑第一步即可。

12.6 排错对照