内容
<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/intel-mcp</h1>
<p align="center"><strong>以智能资金视角读取市场 — 智能资金评分、钱包情报、信号源、KOL 交易以及跟单交易目录，均来自任意 AI 代理。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/intel-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/intel-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/intel-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/intel-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>
---
> 一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为任意 AI 助手提供 three.ws **市场情报** 接口，基于标准输入输出。可以通过购买者判断一枚币的价值，获取钱包的实现声誉，读取信号源的已证实准确率，排名 KOL 交易员，并浏览跟单智能资金目录 — 所有数据均为实时、只读、无需密钥。
所有评分、信号和排名均直接来自 three.ws 公共 API。无需 API 密钥，无需签名，无需支付 — 将 `THREE_WS_BASE` 指向部署并启动。
## 安装
```bash
npm install @three-ws/intel-mcp
```
或使用 `npx`（无需安装）：
```bash
npx @three-ws/intel-mcp
```
## 快速开始
**Claude 代码**，一行：
```bash
claude mcp add intel -- npx -y @three-ws/intel-mcp
```
**Claude 桌面版 / Cursor**（`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"intel": {
"command": "npx",
"args": ["-y", "@three-ws/intel-mcp"]
}
}
}
```
使用 MCP 检视器检视界面：
```bash
npx -y @modelcontextprotocol/inspector npx @three-ws/intel-mcp
```
## 工具
| 工具 | 类型 | 功能 |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------------ |
| `smart_money_coin` | 只读 | 以智能资金视角评分一枚币 — 0–100 智能资金评分、可信购买者、资金集群、女巫标记。 |
| `wallet_intel` | 只读 | 一个钱包的实现声誉：评分、胜率、行为标签及其资金集群。 |
| `signal_feed` | 只读 | 信号源的已证实准确率（命中率、实现 / 跟随者 ROI）以及最近的链上证明排放。 |
| `kol_leaderboard` | 只读 | 在 7 天 / 30 天窗口期内，按实现盈亏排名的 KOL 交易员。 |
| `kol_trades` | 只读 | 特定铸造代币上的近期 KOL 交易，跨越跟踪的 KOL 集合。 |
| `copy_smart_wallets` | 只读 | 浏览排名的跟单智能资金目录 — 按链、类别和排序筛选。 |
所有六种工具均读取实时数据：评分、信号源和排名在调用之间发生变化，因此无幂等性。
### 输入参数
**`smart_money_coin`** — `mint`（必填），`network`（`mainnet` | `devnet`，默认为 `mainnet`）。
**`wallet_intel`** — `wallet`（必填），`network`（`mainnet` | `devnet`，默认为 `mainnet`）。
**`signal_feed`** — `slug`（必填），`network`（`mainnet` | `devnet`，默认为 `mainnet`）。
**`kol_leaderboard`** — `window`（`7d` | `30d`，默认为 `7d`），`limit`（1–100，默认为 25）。
**`kol_trades`** — `mint`（必填），`limit`（1–100，默认为 20）。
**`copy_smart_wallets`** — `chain`（`sol` | `bsc`），`category`（`smart_money` | `launchpad` | `kol` | `sniper`），`sort`（`profit` | `pnl` | `winrate` | `followers` | `score`，默认为 `score`），`q`（文本），`limit`（1–100，默认为 30），`offset`（默认为 0）。
## 示例
```jsonc
// copy_smart_wallets
> { "chain": "sol", "sort": "winrate", "limit": 3 }
{
"ok": true,
"count": 3,
"total": 412,
"offset": 0,
"limit": 3,
"has_more": true,
"facets": { "byChain": { "sol": 300, "bsc": 112 }, "byCategory": { "smart_money": 180, "kol": 90 } },
"wallets": [
{ "address": "…", "chain": "sol", "categories": ["smart_money"], "score": 94, "win_rate_30d": 0.71, "realized_profit_30d_usd": 182000, "follow_count": 1240 }
]
}
```
```jsonc
// smart_money_coin
> { "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump" }
{
"ok": true,
"mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
"network": "mainnet",
"computed": true,
"smart_money_score": 78,
"reputable_buyers": 12,
"sybil_flag": false,
"sybil_share": 0.18,
"wallets": [ /* 可信购买者，附带实现评分、胜率、标签 */ ],
"clusters": [ /* 资金集群 */ ]
}
```
`computed: false` 表示智能资金图表尚未有链上历史记录 — 这是诚实的“数据不足”，而非失败。
## 要求
- **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)。未经版权所有者明确书面许可，不得授予任何权利。
