Metadata-Version: 2.4
Name: bili_stalker_mcp
Version: 2.3
Summary: MCP Server for getting Bilibili user video updates
Author-email: 222wcnm <2328072813li@gmail.com>
Maintainer-email: 222wcnm <2328072813li@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/222wcnm/BiliStalkerMCP
Project-URL: Documentation, https://github.com/222wcnm/BiliStalkerMCP#readme
Project-URL: Repository, https://github.com/222wcnm/BiliStalkerMCP
Project-URL: Issues, https://github.com/222wcnm/BiliStalkerMCP/issues
Project-URL: Changelog, https://github.com/222wcnm/BiliStalkerMCP/releases
Keywords: mcp,bilibili,stalker,video,updates,ai,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Communications
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bilibili-api-python>=17.1.4
Requires-Dist: fastmcp>=0.4.0
Requires-Dist: mcp[cli]>=1.11.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: async-lru>=2.0.4
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# BiliStalkerMCP

[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python)](https://www.python.org/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-orange)](https://github.com/jlowin/fastmcp)
[![Version](https://img.shields.io/badge/Version-2.3-green)](https://pypi.org/project/bili-stalker-mcp/)

A Model Context Protocol (MCP) server for comprehensive Bilibili user data acquisition.

## Quick Start

### Installation
```bash
uvx bili-stalker-mcp
```

### Configuration
Add to your MCP client settings:

```json
{
  "mcpServers": {
    "bilistalker": {
      "command": "uvx",
      "args": ["bili-stalker-mcp"],
      "env": {
        "SESSDATA": "your_sessdata",
        "BILI_JCT": "your_bili_jct",
        "BUVID3": "your_buvid3"
      }
    }
  }
}
```

## Available Tools

| Tool | Description | Parameters |
|------|-------------|------------|
| `get_user_info` | User profile and stats | `user_id` or `username` |
| `get_user_video_updates` | Video publications with subtitles | `user_id`/`username`, `page`, `limit` |
| `get_user_dynamic_updates` | User dynamics with type filtering | `user_id`/`username`, `offset`, `limit`, `dynamic_type` |
| `get_user_articles` | Article publications | `user_id`/`username`, `page`, `limit` |
| `get_user_followings` | Following list | `user_id`/`username`, `page`, `limit` |

## Development

```bash
# Clone and setup
git clone https://github.com/222wcnm/BiliStalkerMCP.git
cd BiliStalkerMCP
uv pip install -e .

# Run tests
python tests/test_suite.py -u <user_id_or_username>
```

## License

MIT
