内容
<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/kol-mcp</h1>
<p align="center"><strong>跟踪一位智能交易者 — 跟踪 KOL 钱包的投资组合盈亏和交易记录。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/kol-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/kol-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/kol-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/kol-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>
---
> 一个用于 **单个钱包 KOL 深入分析** 的 [模型上下文协议](https://modelcontextprotocol.io) 服务器。 [`@three-ws/intel-mcp`](https://www.npmjs.com/package/@three-ws/intel-mcp) 排行整个跟踪的 KOL 集（`kol_leaderboard`）并显示每个人的交易记录在一个代币上（`kol_trades`），这个服务器聚焦于 **一个** 智能交易者：提取他们的实时投资组合盈亏卡，然后检查他们自己的特定代币买卖记录 — 所有智能体需要的东西，以决定是否复制或分析他们。
投资组合盈亏来自 three.ws Birdeye 代理（Birdeye 密钥存储在服务器端）；交易历史记录来自 three.ws Helius 支持的 KOL 馈送。所有实时，只读 — 无需客户端 API 密钥、签名者或付款。指向 `THREE_WS_BASE` 到部署并启动。
## 安装
```bash
npm install @three-ws/kol-mcp
```
或使用 `npx` 运行（无需安装）：
```bash
npx @three-ws/kol-mcp
```
## 快速开始
**Claude Code**，一行：
```bash
claude mcp add kol -- npx -y @three-ws/kol-mcp
```
**Claude Desktop / Cursor** (`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"kol": {
"command": "npx",
"args": ["-y", "@three-ws/kol-mcp"]
}
}
}
```
使用 MCP Inspector 检查表面：
```bash
npx -y @modelcontextprotocol/inspector npx @three-ws/kol-mcp
```
## 工具
| 工具 | 类型 | 功能 |
| ---------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| `get_wallet_portfolio` | 只读 | 一个 KOL 钱包的实时投资组合盈亏卡：已实现盈亏，未实现（开放仓位）盈亏，胜率，总交易次数，最大持仓。 |
| `get_wallet_trades` | 只读 | 该钱包最近买卖的给定代币记录 — 买卖双方，SOL 大小，代币金额，价格，美元价值和时间，新记录优先。 |
两个工具都读取实时数据：投资组合盈亏和交易馈送在调用之间移动，因此两者都不是幂等的。
### 输入参数
**`get_wallet_portfolio`** — `wallet`（必填）。
**`get_wallet_trades`** — `wallet`（必填），`mint`（必填），`limit`（1-100，默认 20）。
> three.ws 交易馈送是按代币键控的（它扫描每个跟踪的 KOL 钱包在一个代币上的活动），因此按钱包视图是该馈送缩小到您的钱包。 `get_wallet_trades` 因此需要一个 `wallet` 和一个 `mint`。要查看 **所有** 跟踪的钱包在一个代币上的交易记录，请使用 [`@three-ws/intel-mcp`](https://www.npmjs.com/package/@three-ws/intel-mcp) 中的 `kol_trades`。
## 示例
```jsonc
// get_wallet_portfolio
> { "wallet": "5xY…KoL" }
{
"ok": true,
"wallet": "5xY…KoL",
"has_activity": true,
"realized_pnl_usd": 124300,
"unrealized_pnl_usd": 38120,
"win_rate": 0.64,
"total_trades": 412,
"top_token": { "symbol": "THREE", "pnl": 38120 }
}
```
```jsonc
// get_wallet_trades
> { "wallet": "5xY…KoL", "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump", "limit": 3 }
{
"ok": true,
"wallet": "5xY…KoL",
"mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
"count": 2,
"trades": [
{ "side": "buy", "amountSol": 4.2, "amountToken": 1830000, "price": 0.0000022, "usd": 612.4, "time": "2026-06-24T09:12:03.000Z", "source": "kol", "label": "Top Trader" }
]
}
```
`has_activity: false` 在投资组合上（所有零盈亏，无交易，无持仓）意味着代理没有该地址的记录 — 一个诚实的“无数据”，不是失败。
## 要求
- **Node.js >= 20.**
- 访问 `https://three.ws` 的网络权限（或您自己的 `THREE_WS_BASE`）。
### 环境变量
| 变量 | 必需 | 默认 |
| --------------------- | -------- | ------------------ |
| `THREE_WS_BASE` | 否 | `https://three.ws` |
| `THREE_WS_TIMEOUT_MS` | 否 | `20000` |
客户端无密钥：支持投资组合盈亏的 Birdeye 密钥和交易馈送背后的 Helius 密钥都存储在 three.ws 服务器端。
## 链接
- 首页：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)。未经版权所有者明确书面许可，不得授予任何权利。
