Weibo MCP Server 🚀

基于 Model Context Protocol 的微博数据 API 服务器 - 实时获取微博用户资料、帖子、热搜话题、粉丝/关注数据。支持用户搜索、内容分析和话题发现，适用于 AI 应用。

安装

自动 Cookie 获取： 无需手动配置 Cookie，程序会自动通过微博访客通行证生成有效的访问凭证。

方式一：从包管理器安装（推荐）

# 安装
uvx install mcp-server-weibo

# 以 stdio 模式运行
mcp-server-weibo stdio

# 以 http 模式运行
mcp-server-weibo http

MCP 客户端配置（stdio 模式）：

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

方式二：从 Docker 运行

# 构建镜像
docker build -t mcp-server-weibo .

# 运行容器
docker run -p 4200:4200 mcp-server-weibo http

MCP 客户端配置（HTTP 模式）：

{
  "mcpServers": {
    "weibo": {
      "url": "http://localhost:4200/sse"
    }
  }
}

方式三：从源代码安装

# 克隆并安装
git clone https://github.com/qinyuanpei/mcp-server-weibo.git
cd mcp-server-weibo
uv pip install -e .

# 运行
mcp-server-weibo stdio   # 或 http

命令行工具 (CLI)

除了 MCP 服务器，还提供了独立的命令行工具可直接访问：

# 使用 uvx 运行 (推荐)
uvx --from mcp-server-weibo weibo-cli --help

# 安装后运行
pip install mcp-server-weibo
weibo-cli --help

# 获取用户资料
uvx --from mcp-server-weibo weibo-cli profile 1749127163

# 获取用户动态
uvx --from mcp-server-weibo weibo-cli feeds 1749127163 -n 10

# 搜索内容
uvx --from mcp-server-weibo weibo-cli search "关键词"

# 搜索用户
uvx --from mcp-server-weibo weibo-cli users "关键词"

# 搜索话题
uvx --from mcp-server-weibo weibo-cli topics "关键词"

# 获取热搜榜单
uvx --from mcp-server-weibo weibo-cli trending -n 10

# 获取评论
uvx --from mcp-server-weibo weibo-cli comments 5173507416919189

# 获取粉丝
uvx --from mcp-server-weibo weibo-cli followers 1749127163 -n 10

# 获取关注
uvx --from mcp-server-weibo weibo-cli fans 1749127163 -n 10

CLI 命令列表

组件

工具

search_users(keyword, limit)

描述：搜索微博用户

返回示例：

[
  {
    "id": 1749127163,
    "screen_name": "雷军",
    "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Expires=1749109677&ssig=QzOuVFBlRp",
    "profile_url": "https://m.weibo.cn/u/1749127163?",
    "description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
    "follow_count": 1562,
    "followers_count": "2671.2万",
    "avatar_hd": "https://wx1.sinaimg.cn/orj480/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg",
    "verified": true,
    "verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
    "gender": "m"
  }
]

get_profile(uid)

描述：获取用户详细信息

返回示例：

{
  "id": 1749127163,
  "screen_name": "雷军",
  "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Expires=1749109733&ssig=5OrMoqbwcY",
  "profile_url": "https://m.weibo.cn/u/1749127163?",
  "description": "小米董事长，金山软件董事长。业余爱好是天使投资。",
  "follow_count": 1562,
  "followers_count": "2671.2万",
  "avatar_hd": "https://wx1.sinaimg.cn/orj480/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg",
  "verified": true,
  "verified_reason": "小米创办人，董事长兼CEO；金山软件董事长；天使投资人。",
  "gender": "m"
}

get_feeds(uid, limit)

描述：获取用户帖子

返回示例：

[
  {
    "id": 5167970394572058,
    "text": "今年是小米创业15周年。<br />早在11年前，2014年，我们就开始芯片研发之旅。<br /><br />2014年9月，澎湃项目立项。2017年，小米首款手机芯片"澎湃S1"正式亮相，定位中高端。后来，因为种种原因，遭遇挫折，我们暂停了SoC大芯片的研发。但我们还是保留了芯片研发的火种，转向了"小芯片"路线。再后来，小米澎湃各 ...<a href=\"/status/5167970394572058\">全文</a>",
    "source": "Xiaomi 15S Pro",
    "created_at": "Mon May 19 11:00:21 +0800 2025",
    "user": {
      "id": 1749127163,
      "screen_name": "雷军",
      "profile_image_url": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/001Un9Srly8i1p6mooym8j60u00u10tu02.jpg?KID=imgbed,tva&Exp

... [View full README on GitHub](https://github.com/qinyuanpei/mcp-server-weibo#readme)