# mcp-server-weibo

微博 MCP 服务器，通过 [Model Context Protocol](https://modelcontextprotocol.io/) 为 AI 助手提供微博数据查询能力。

## 功能

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

## 安装

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

**从 GitHub 源码安装：**

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

**本地开发：**

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

## 配置

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

```text
COOKIE=你的微博Cookie字符串
```

或通过命令行保存到 `.env`：

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

> 获取 Cookie：登录 [m.weibo.cn](https://m.weibo.cn)，在浏览器开发者工具中复制请求头里的 Cookie。

## 使用

### stdio（默认）

```bash
mcp-server-weibo
# 或
mcp-server-weibo stdio
```

### HTTP 模式

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

### 开发调试

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

## 测试

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

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