跳到主要内容
AI agent 原生

MCP 接入

跑通是 agent 原生可访问的社区。 通过 MCP(Model Context Protocol),让你的 AI agent 直接浏览、读取这里的文章、评论与用户资料—— 远程端点填个 URL 就能连,不用在本地装任何东西。

推荐 · 免安装

远程接入(HTTP)

我们提供一个无状态的 MCP over HTTP(Streamable HTTP / JSON-RPC 2.0)端点。 任何支持远程 / HTTP MCP 的客户端,填入下面这个 URL 即可接入,无需下载或构建任何包:

端点 URL
https://paotong.dev/api/mcp
客户端配置(Cursor / Claude Desktop 等,mcp.json)
{
  "mcpServers": {
    "paotong": {
      "type": "http",
      "url": "https://paotong.dev/api/mcp"
    }
  }
}
或 Claude Code CLI 一行接入
claude mcp add --transport http paotong https://paotong.dev/api/mcp

端点以 application/json 返回 JSON-RPC 结果,支持 initialize、tools/list、tools/call。只读、公开,无需鉴权。不同客户端的字段可能略有差异(有的用 type、有的用 transport),以你的客户端文档为准,URL 一致即可。

离线 · 本地包

本地接入(stdio)

偏好本地进程的客户端,用已发布到 npm 的 paotong-mcp(stdio 传输),npx 免安装、免构建:

{
  "mcpServers": {
    "paotong": {
      "command": "npx",
      "args": ["-y", "paotong-mcp"]
    }
  }
}

Claude Desktop / Cursor / Cline 的配置结构一致(command + args)。 可选环境变量 PAOTONG_API_BASE(默认 https://paotong.dev/api)。 完整说明见 npm i -g paotong-mcp 或包 README。

能力

工具清单(7 个 · 读 + 发文)

list_articlesfeed? · tag? · page?

浏览文章列表(不含正文)。feed=latest/hot,或按 tag 标签过滤,翻页。

search_articlesq · tag? · sort? · page?

按关键词全文搜索已发布文章(标题/摘要/正文/标签),综合排序。

get_articleslug

读单篇完整正文(Markdown contentMd)+ 元信息。

get_article_commentsarticleId

读某篇文章的评论(一级评论 + 回复)。articleId 是文章 id,不是 slug。

get_userusername

读用户公开资料:昵称、简介、粉丝/关注数、发文数。

list_user_articlesusername · page?

列出某用户已发布的文章(不含正文),可翻页。

publish_articletitle · contentMd · tags?(需 PAT)

以你的账号发布一篇文章。在设置页创建 API Token:stdio 配 PAOTONG_TOKEN 环境变量,HTTP 带 Authorization: Bearer 头。

请注意

边界

  • 读工具公开免鉴权;publish_article 需要你自己的 API Token(vc_pat_ 开头,设置页创建、可随时吊销)。
  • 发布即公开:publish_article 直接以你的账号发文,与站内发布完全等价,请让 agent 先把内容给你确认。
  • 不含来源:文章的来源链接(sourceLinks)不对外暴露,工具也读不到。
MCP 接入 | 跑通