内容
<p align="center">
<a href="https://three.ws"><img src="https://three.ws/three-ws-mcp-icon.svg" alt="three.ws" width="88" height="88"></a>
</p>
<h1 align="center">@three-ws/activity-mcp</h1>
<p align="center"><strong>three.ws 当前的热门内容 — trending agents and coins, $THREE 持有人排行榜及各层级的划分，以及来自任何 AI 代理的站点范围活动 ticker。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/activity-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/activity-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/activity-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/activity-mcp?color=339933&logo=node.js">
<a href="https://registry.modelcontextprotocol.io/?q=io.github.nirholas"><img alt="MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-io.github.nirholas-0ea5e9"></a>
<a href="https://three.ws"><img alt="three.ws" src="https://img.shields.io/badge/built%20by-three.ws-000"></a>
</p>
---
> 一个 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，为任何 AI 助手提供 three.ws 的**实时发现**界面，基于 stdio。查看哪些代理通过实时聊天活动排名，哪些代币 Oracle 有最高的信念，钱包在 $THREE 持有人排行榜上的位置，每个持有人层级的含义，以及当前整个平台正在发生什么 — 所有这些都是实时的，只读的，无需密钥。
所有排名、层级和事件都直接来自公开的 three.ws API。无需 API 密钥，无需签名者，无需付款 — 将 `THREE_WS_BASE` 指向部署并启动。
## 安装
```bash
npm install @three-ws/activity-mcp
```
或使用 `npx` 运行（无需安装）：
```bash
npx @three-ws/activity-mcp
```
## 快速开始
**Claude Code**，一行命令：
```bash
claude mcp add activity -- npx -y @three-ws/activity-mcp
```
**Claude Desktop / Cursor** (`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"activity": {
"command": "npx",
"args": ["-y", "@three-ws/activity-mcp"]
}
}
}
```
使用 MCP Inspector 检查界面：
```bash
npx -y @modelcontextprotocol/inspector npx @three-ws/activity-mcp
```
## 工具
| 工具 | 类型 | 功能 |
| ------------------------ | --------- | ------------------------------------------------------------------------------------------------------------ |
| `get_trending_agents` | 只读 | 代理按 24 小时 / 7 天 / 所有时间窗口的真实聊天活动排名 — 可选地混合钱包信任声誉。 |
| `get_trending_coins` | 只读 | 代币按 Oracle 的 0–100 信念评分排名，包含动力 / 血统 / 结构 / 叙事子评分。 |
| `get_holder_leaderboard` | 只读 | $THREE 持有人排行榜，按链上余额排名，包含层级、实时市场行情和“你是 #N”查找。 |
| `get_tier_info` | 只读 | $THREE 持有人层级表 — 每个层级的标签、最低余额和徽章颜色。 |
| `get_feed_events` | 只读 | 全站活动 ticker — 代币购买、代理部署、升级、支付等，最新优先。 |
所有五个工具都读取实时数据：排名、持有人排行榜和动态信息在调用之间移动，因此没有一个是幂等的。
### 输入参数
**`get_trending_agents`** — `window` (`24h` | `7d` | `all`，默认 `24h`)，`sort` (`activity` | `trust`，默认 `activity`)，`limit` (1–20，默认 10)。
**`get_trending_coins`** — `limit` (1–20，默认 10)。
**`get_holder_leaderboard`** — `limit` (1–100，默认 50)，`offset` (默认 0)，`wallet` (可选 base58 — 添加钱包自身的“你”排名)。
**`get_tier_info`** — 无参数。
**`get_feed_events`** — `limit` (1–100，默认 30)。
## 示例
```jsonc
// get_trending_agents
> { "window": "7d", "limit": 2 }
{
"ok": true,
"window": "7d",
"sort": "activity",
"generated_at": "2026-06-24T12:00:00.000Z",
"count": 2,
"agents": [
{
"rank": 1,
"id": "…",
"name": "Luna",
"description": "A 3D companion agent",
"avatar_thumbnail_url": "https://…",
"chat_count": 18420,
"window_chats": 2310,
"is_onchain": true,
"agent_url": "https://three.ws/agent/…",
"reputation": { "score": 82, "tier": "trusted", "tierLabel": "Trusted", "isNew": false }
}
]
}
```
```jsonc
// get_holder_leaderboard
> { "limit": 1, "wallet": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump" }
{
"ok": true,
"mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
"total": 4821,
"supply": 1000000000,
"decimals": 6,
"holders": [
{ "rank": 1, "wallet": "…", "wallet_short": "AbCd…wXyZ", "amount": 42000000, "pct_of_supply": 0.042, "tier": "genesis" }
],
"tiers": [ { "id": "genesis", "label": "Genesis", "min": 10000000, "accent": "#f5d0a9" } ],
"market": { "price_usd": 0.0031, "market_cap": 3100000, "holders": 4821 },
"you": { "rank": 137, "amount": 25400, "pct_of_supply": 0.0000254, "tier": "gold" }
}
```
$THREE 持有人排行榜仅适用于 **$THREE** — three.ws 唯一对持有者进行排名的代币（CA `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`）。 trending-coins 列表是平台的运行时启动目录发现数据：一个排名反映 Oracle 评分的列表，而不是对任何代币的推荐。
## 要求
- **Node.js >= 20.**
- 可以访问 `https://three.ws` 的网络（或您自己的 `THREE_WS_BASE`）。
### 环境变量
| 变量 | 是否必需 | 默认值 |
| --------------------- | -------- | ------------------ |
| `THREE_WS_BASE` | 否 | `https://three.ws` |
| `THREE_WS_TIMEOUT_MS` | 否 | `20000` |
## 链接
- 首页：https://three.ws
- 更新日志：https://three.ws/changelog
- 问题：https://github.com/nirholas/three.ws/issues
- 许可证：Apache-2.0 — 见 [LICENSE](./LICENSE)
---
<p align="center">
<sub>
three.ws SDK 套件的一部分 — 3D AI 代理、链上身份和代理支付。<br/>
<a href="https://three.ws">网站</a> · <a href="https://three.ws/changelog">更新日志</a> · <a href="https://github.com/nirholas/three.ws">GitHub</a>
</sub>
</p>
## 许可证
Copyright © 2026 nirholas. All rights reserved.
本软件为专有软件 — 见 [LICENSE](./LICENSE)。未经版权所有者明确书面许可，不得授予任何权利。
