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