微博热搜MCP服务器

这是一个基于模型上下文协议（MCP）框架的微博热搜数据采集服务器，提供获取微博热搜列表、热搜详情及评论的功能。

功能

1. 获取微博热搜列表

   • 显示热搜排名
   • 展示热搜关键词
   • 展示热搜指数

2. 获取热搜详情

   • 主题类别
   • 主题描述
   • 主题链接
   • 主题声明信息
   • 统计数据（阅读量、讨论量、互动量、原创帖子数）

3. 获取热搜评论

   • 支持通过热搜链接获取第一条微博或声明帖子的评论
   • 可配置的最大评论获取数量
   • 显示评论内容及点赞数

要求

• Python >=3.10
• 依赖项：
  • requests
  • lxml
  • mcp>=1.0.0

安装

从源代码安装

1. 克隆仓库

git clone https://github.com/Yooki-K/weibo-mcp-server.git

2. 安装依赖项：

pip install -r requirements.txt

注意：如果使用uv run weibo_mcp_server，依赖项会自动安装，无需执行pip install

从Pypi安装

pip install weibo-mcp-server

配置

获取微博Cookie

创建一个微博账户，按F12打开开发者工具，并按照下图所示获取Cookie：

在本地运行项目

将此工具添加到MCP服务器中

Cursor

在Windows上：C:/Users/YOUR_USER/.cursor/mcp.json

{
  "mcpServers": {
    "weibo": {
      "command": "uv",
      "args": [
         "--directory",
         "path/to/weibo-mcp-server",
         "run",
         "weibo_mcp_server"
      ],
      "env":{
        "weibo_COOKIE": YOUR_WEIBO_COOKIE
      }
    }
  }
}

Claude

在Windows上：%APPDATA%/Claude/claude_desktop_config.json

"weibo": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/weibo-mcp-server",
      "run",
      "weibo_mcp_server"
    ],
    "env": {
      "weibo_COOKIE": YOUR_WEIBO_COOKIE
    }
  }

许可证

MIT许可证 - 详情见LICENSE文件。

贡献指南

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些精彩功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求