微博数据查询服务器

微博 MCP 服务器通过 Model Context Protocol 为 AI 助手提供微博数据查询能力,包括用户搜索、动态获取、热搜榜查询等功能。

  • by InfernalAzazel
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 InfernalAzazel/mcp-server-weibo

使用说明

mcp-server-weibo

微博 MCP 服务器,通过 Model Context Protocol 为 AI 助手提供微博数据查询能力。

功能

工具 说明
search_users 根据关键词搜索微博用户
get_profile 获取用户资料
get_feeds 获取用户动态
get_hot_feeds 获取用户热门动态
get_trendings 获取微博热搜榜
search_content 搜索微博内容
search_topics 搜索微博话题
get_followers 获取用户关注列表
get_fans 获取用户粉丝列表
get_comments 获取帖子评论

安装

在 MCP 客户端的配置中添加:

从 GitHub 源码安装:

{
  "mcpServers": {
    "weibo": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/InfernalAzazel/mcp-server-weibo.git",
        "mcp-server-weibo"
      ],
      "env": {
        "COOKIE": "你的微博 cookie"
      },
    }
  }
}

本地开发:

uv pip install -e .
# 或
pip install -e .

配置

需要配置微博 Cookie 才能调用 API。在 env 中设置 COOKIE,或在项目目录下创建 .env:

COOKIE=你的微博Cookie字符串

或通过命令行保存到 .env:

mcp-server-weibo --cookie "你的微博Cookie"

获取 Cookie:登录 m.weibo.cn,在浏览器开发者工具中复制请求头里的 Cookie。

使用

stdio(默认)

mcp-server-weibo
# 或
mcp-server-weibo stdio

HTTP 模式

mcp-server-weibo http
# 默认端口 4200,可通过环境变量 PORT 修改
PORT=8080 mcp-server-weibo http

开发调试

uv run fastmcp dev inspector src/mcp_server_weibo/server.py --ui-port 3666 --server-port 3667

测试

# 运行所有测试
uv run pytest tests/ -v

# 需要 COOKIE 的 API 测试(未配置会跳过)
uv run pytest tests/test_weibo.py -v