BlockBeats MCP服务器使用说明

项目简介

BlockBeats MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为AI Agent提供最新的区块链行业快讯和深度分析文章。通过集成BlockBeats的内容API，本服务器能够让AI Agent便捷地获取行业动态，作为上下文信息辅助决策或内容生成。

主要功能点

区块链快讯检索: 提供'get_latest_news'工具，快速获取BlockBeats的最新快讯，支持分页和类型筛选。
区块链深度文章检索: 提供'get_latest_articles'工具，获取BlockBeats的深度分析文章，同样支持分页和类型筛选。
多语言支持: 支持中文（简体和繁体）和英文资讯内容。
易于部署: 使用'mcp'框架搭建，方便快捷地安装和运行。

安装步骤

克隆仓库

git clone https://github.com/kukapay/blockbeats-mcp.git
cd blockbeats-mcp

安装依赖 确保已安装Python 3.10 或更高版本。

pip install mcp[cli] httpx

运行服务器
- 开发模式 (热重载): 方便开发调试，修改代码后服务器自动重启。
```
mcp dev main.py
```
- 生产模式 (例如配合Claude Desktop): 将服务器安装为MCP应用，方便客户端发现和连接。
```
mcp install main.py --name "BlockBeats News"
```

服务器配置

MCP客户端需要配置服务器的启动命令和参数才能连接。以下是针对不同运行模式的配置信息（JSON格式）：

开发模式配置:

{
  "server_name": "BlockBeats News",  // MCP服务器名称，可以自定义
  "command": "mcp",                 // 启动命令，通常为 mcp
  "args": ["dev", "main.py"]       // 启动参数，指定运行开发模式并执行 main.py
}

生产模式 (install) 配置 (Claude Desktop等客户端可能需要):

{
  "server_name": "BlockBeats News",  // MCP服务器名称，与安装时指定的名称一致
  "command": "mcp",                 // 启动命令，通常为 mcp
  "args": ["run", "blockbeats-news"] // 启动参数，运行名为 blockbeats-news 的已安装服务器
}

注意: 生产模式配置中的 '"args": ["run", "blockbeats-news"]' 假设您在安装时使用了 '--name "BlockBeats News"'，实际的名称需要与安装时 '--name' 参数保持一致 (将空格替换为 '-' 并转换为小写)。如果您使用 'mcp install main.py' 安装，则默认名称可能是基于 'main.py' 文件名生成的。

基本使用方法

服务器启动后，MCP客户端可以通过JSON-RPC协议与其通信，调用以下工具获取区块链资讯：

'get_latest_news': 获取最新快讯。
- 参数:
  - 'size' (整数, 可选): 每页文章数量，默认为 5。
  - 'max_pages' (整数, 可选): 最大获取页数，默认为 1。
  - 'type' (字符串, 可选): 新闻类型过滤器，例如 'push' 代表重要新闻，默认为 'push'。
  - 'lang' (字符串, 可选): 语言，'en' 代表英文, 'cn' 代表简体中文, 'cht' 代表繁体中文，默认为 'en'。
'get_latest_articles': 获取最新深度文章。
- 参数:
  - 'size' (整数, 可选): 每页文章数量，默认为 5。
  - 'max_pages' (整数, 可选): 最大获取页数，默认为 1。
  - 'type' (字符串, 可选): 文章类型过滤器，例如 'push' 代表重要文章，默认为 'push'。
  - 'lang' (字符串, 可选): 语言，'en' 代表英文, 'cn' 代表简体中文, 'cht' 代表繁体中文，默认为 'en'。

示例 (MCP客户端请求 'get_latest_news' 工具):

{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "tool_call_id": "get_latest_news_1",
    "tool_name": "get_latest_news",
    "parameters": {
      "size": 3,
      "lang": "cn"
    }
  },
  "id": 1
}

服务器将返回包含快讯文章信息的JSON-RPC响应。

关键词