mcpField
W
Weibo MCP Server

Weibo MCP Server

Local
github.com/qinyuanpeiSocial Media63Updated 6w ago
Repository

About Weibo MCP Server

Weibo MCP Server is an MCP server that provides Weibo user, post, trending, comment, topic and social relationship data. It also ships a command line tool that outputs JSON, aimed at AI application developers and data users.

Key features

  1. 01Fetch user profiles and post feeds
  2. 02Query trending topics and topic data
  3. 03Search users and post content
  4. 04Run over stdio or Streamable HTTP
  5. 05weibo-cli command line tool with JSON output
  6. 06Optional QR code login stored locally

Use cases

  1. 01Feed trending Weibo topics into AI applications
  2. 02Export Weibo data as JSON in scripts or pipelines
  3. 03Let coding agents call Weibo data through the CLI

MCP support

The project runs as an MCP server, offering Weibo data tools to MCP clients over stdio or an HTTP endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "weibo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Weibo MCP Server

mcp-server-weibo cover

通过微博访客接口提供用户、微博、热搜、评论、话题及社交关系数据。默认自动申请访客 Cookie，不读取用户手工提供的 Cookie；CLI 可通过扫码登录保存本机登录会话。

选择适合你的方式

你的目标选择
让支持 Skill 的编码代理按项目约定调用 CLIWeibo CLI Skill
让 Agent 抓取微博数据并生成人格画像报告Weibo Personality Skill
让 Claude、Cursor 或其他 AI 客户端自主调用微博工具MCP 接入指南
在终端、脚本或管道中直接取得 JSON 数据CLI 使用指南

快速开始

MCP
{
  "mcpServers": {
    "weibo": {
      "command": "uvx",
      "args": ["--from", "mcp-server-weibo", "mcp-server-weibo"]
    }
  }
}

HTTP 模式使用 Streamable HTTP 端点 http://localhost:4200/mcp。完整配置、工具清单与测试方法见 MCP 接入指南。

CLI
uvx --from mcp-server-weibo weibo-cli trending -n 3
uvx --from mcp-server-weibo weibo-cli users "雷军" -n 5
uvx --from mcp-server-weibo weibo-cli feeds 1749127163 -n 10 --no-include-pics

# 可选：扫码创建本机 CLI 登录会话
uvx --from mcp-server-weibo weibo-cli login

# 校验当前本机 CLI 登录会话
uvx --from mcp-server-weibo weibo-cli session

集合查询命令输出一个完整 JSON 数组；profile 输出对象，session 输出登录会话对象或 null。完整命令、分页和精简输出选项见 CLI 使用指南。

从源码运行

git clone https://github.com/qinyuanpei/mcp-server-weibo.git
cd mcp-server-weibo
uv sync --extra dev

# MCP：stdio 或 HTTP
uv run mcp-server-weibo
uv run mcp-server-weibo http

# CLI
uv run weibo-cli --help

致谢

CLI 二维码登录功能的协议实现参考并改编自 RicterZ/mcp-server-weibo。感谢其对微博二维码登录流程的实现与公开分享。

要求与声明

  • Python >= 3.10
  • MIT License，详见 LICENSE
  • 本项目与微博官方无关，仅用于学习和研究。

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.