BlockBeats MCP Server

1# BlockBeats MCP Server
2 
3An MCP server that delivers blockchain news and in-depth articles from BlockBeats for AI agents.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/blockbeats-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9*Try [Kukapay News MCP](https://github.com/kukapay/kukapay-news-mcp) — no API key required, fully AI-annotated*.
10 
11## Features
12 
13- **Fast News Retrieval**: Fetch the latest blockchain fast news articles using the `get_latest_news` tool.
14- **In-Depth Articles**: Access detailed blockchain articles with the `get_latest_articles` tool.
15- **Multi-Language Support**: Supports English (`en`), Simplified Chinese (`cn`), and Traditional Chinese (`cht`).
16 
17## Installation
18 
19### Installing via Smithery
20 
21To install BlockBeats News for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/blockbeats-mcp):
22 
23```bash
24npx -y @smithery/cli install @kukapay/blockbeats-mcp --client claude
25```
26 
27### Manual Installation
281. **Clone the Repository**:
29   ```bash
30   git clone https://github.com/kukapay/blockbeats-mcp.git
31   cd blockbeats-mcp
32   ```
33 
342. **Install Dependencies**:
35   ```bash
36   pip install mcp[cli] httpx
37   ```
38 
393. **Run the Server**:
40   - For development mode (hot reload enabled):
41     ```bash
42     mcp dev main.py
43     ```
44   - For production use with Claude Desktop:
45     ```bash
46     mcp install main.py --name "BlockBeats News"
47     ```
48     
49## Usage
50 
51The server provides two main tools:
52 
53### `get_latest_news`
54Fetches the latest blockchain fast news articles from BlockBeats' `open-api/open-flash` endpoint.
55 
56**Parameters**:
57- `size` (int): Number of articles per page (default: 5).
58- `max_pages` (int): Maximum number of pages to fetch (default: 1).
59- `type` (str): News type filter, e.g., `'push'` for important news (default: `'push'`).
60- `lang` (str): Language of the news (`'en'` for English, `'cn'` for Simplified Chinese, `'cht'` for Traditional Chinese; default: `'en'`).
61 
62**Example**:
63- **Input**: "Get me the 2 latest blockchain news articles in English from one page."
64- **Output**:
65  ```
66  ID: 288909
67  Title: Bitcoin Falls Below $75,000, 24-Hour Drop Widens to 5.75%
68  Content: <p>BlockBeats News, April 9 – According to HTX market data, Bitcoin has fallen below $75,000, currently priced at $74,854, with a 24-hour drop widening to 5.75%.</p>
69  Link: https://m.theblockbeats.info/flash/288909
70  Created: 2025-04-09 15:26:29
71 
72  ID: 288908
73  Title: Ethereum Drops Below $1,400, Down 9.36% in 24 Hours
74  Content: <p>BlockBeats News, April 9 – Per HTX market data, Ethereum has fallen below $1,400, now at $1,398, with a 24-hour decline of 9.36%.</p>
75  Link: https://m.theblockbeats.info/flash/288908
76  Created: 2025-04-09 15:22:24
77  ```
78 
79### `get_latest_articles`
80Fetches in-depth blockchain articles from BlockBeats' `open-api/open-information` endpoint.
81 
82**Parameters**:
83- `size` (int): Number of articles per page (default: 5).
84- `max_pages` (int): Maximum number of pages to fetch (default: 1).
85- `type` (str): Article type filter, e.g., `'push'` for important articles (default: `'push'`).
86- `lang` (str): Language of the articles (`'en'` for English, `'cn'` for Simplified Chinese, `'cht'` for Traditional Chinese; default: `'en'`).
87 
88**Example**:
89- **Input**: "Show me one in-depth blockchain article in English from the first page with push type."
90- **Output**:
91  ```
92  Title: Solo Bitcoin Miners Are Winning More Blocks Lately—What Gives?
93  Description: Using a $180 Bitaxe miner with a 1.2 TH/s hash rate, the daily chance of mining a block is just 0.00068390%.
94  Content: <blockquote>Original Title: Solo Bitcoin Miners Are Winning More Blocks Lately—What Gives?</blockquote><blockquote>Author: Mat Di Salvo, Decrypt</blockquote><blockquote>Translated by: Lila, BlockBeats</blockquote><p><br></p><p>Last week, another solo Bitcoin miner successfully mined a block, earning a reward of 3.125 BTC, worth nearly $260,000 including transaction fees. This is just one of several recent wins for solo miners in recent months.</p><p><br></p><p>Was this miner just lucky? Is solo mining becoming more common? Can an average person with a basic miner and modest hash power take on the big mining firms?</p><p><br></p><p>The answers vary. While solo miners—here referring to individual enthusiasts or small, low-profile groups—have indeed been mining blocks more often recently, the increase is modest and unlikely to surge dramatically.</p><p><br></p><p><img src="https://image.theblockbeats.info/file_v6/20250408/e870c395-deef-48de-b133-0a5ea85053d5.png?x-oss-process=image/quality,q_50/format,webp" alt="" data-href="" style=""/></p><p><br></p><p>Scott Norris, CEO of solo mining firm Optiminer, put it bluntly: solo mining is still like “buying a lottery ticket.”</p><p><br></p>...
95  Link: https://m.theblockbeats.info/news/57650
96  Created: 2025-04-08 23:30:00
97  ```
98 
99## License
100 
101This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
102