内容
<!-- mcp-name: io.github.omniologynow-rgb/profitspot-mcp -->
<p align="center">
<h1 align="center">ProfitSpot 中文版</h1>
<p align="center">
跨链 DeFi 智能情报，为 AI 代理提供服务。<br/>
风险评分的收益，蒙特卡罗模拟，鲸鱼追踪<br/>
覆盖 86 条链和 6,500+ 个池。
</p>
</p>
<p align="center">
<a href="https://pypi.org/project/profitspot-mcp/"><img src="https://img.shields.io/pypi/v/profitspot-mcp?color=%2334D058&label=pypi" alt="PyPI 版本"></a>
<a href="https://github.com/profitspot/profitspot-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" alt="许可证：AGPL-3.0"></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-8A2BE2" alt="MCP 兼容"></a>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11+-3776AB.svg" alt="Python 3.11+"></a>
<a href="https://profitspot.live"><img src="https://img.shields.io/badge/built%20by-ProfitSpot-ff6b35" alt="由 ProfitSpot 构建"></a>
<a href="https://pepy.tech/project/profitspot-mcp"><img src="https://static.pepy.tech/badge/profitspot-mcp/month" alt="PyPI 每月下载量"></a>
</p>
<p align="center">
<a href="#-快速安装">快速安装</a> •
<a href="#-示例工具调用">示例</a> •
<a href="#-工具参考">工具参考</a> •
<a href="#-定价">定价</a> •
<a href="#-自托管">自托管</a>
</p>
---
## 这是什么？
ProfitSpot 中文版为任何 AI 代理（如 Claude、GPT、Gemini 或您的自定义代理）提供与 [profitspot.live](https://profitspot.live) 相同的 DeFi 情报。可以将其视为 **AI 代理的彭博终端**。
现有的 DeFi MCP 服务器要么是基本的 DeFiLlama 封装器（仅限 1 个工具），要么仅限于单个链。ProfitSpot MCP 涵盖 **86 条链**、**6,500+ 个池**，并添加了一个 **智能层** —— 风险等级、蒙特卡罗利润模拟、鲸鱼检测 —— 而竞争对手没有这些功能。
**不需要 API 密钥即可开始使用。** 免费层立即提供收益发现、市场概览和 IL 计算。
---
## 🚀 快速安装
### Claude 桌面版
将以下内容添加到您的 `claude_desktop_config.json`：
<table>
<tr><td><strong>macOS</strong></td><td><code>~/Library/Application Support/Claude/claude_desktop_config.json</code></td></tr>
<tr><td><strong>Windows</strong></td><td><code>%APPDATA%\Claude\claude_desktop_config.json</code></td></tr>
</table>
```json
{
"mcpServers": {
"profitspot": {
"command": "uvx",
"args": ["profitspot-mcp"],
"env": {
"PROFITSPOT_API_KEY": "您的密钥"
}
}
}
}
```
> **免费层？** 只需完全删除 `"env"` 块。不需要密钥。
### Cursor
将以下内容添加到您的 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"profitspot": {
"command": "uvx",
"args": ["profitspot-mcp"],
"env": {
"PROFITSPOT_API_KEY": "您的密钥"
}
}
}
}
```
### VS Code (Copilot)
将以下内容添加到您的 `.vscode/mcp.json`：
```json
{
"servers": {
"profitspot": {
"type": "stdio",
"command": "uvx",
"args": ["profitspot-mcp"],
"env": {
"PROFITSPOT_API_KEY": "您的密钥"
}
}
}
}
```
### pip（手动安装）
```bash
pip install profitspot-mcp
```
---
## 💡 示例工具调用
来自实时 DeFiLlama 数据的实际响应。每个响应都包含 `confidence`（0–1）和 `data_freshness`（ISO 时间戳）。
### 1. 发现收益 - 以太坊，B 级或更好
```
discover_yields(chain="Ethereum", min_tvl=10000000, min_apy=3, max_risk="B", limit=5)
```
<details>
<summary><strong>完整 JSON 响应</strong>（点击展开）</summary>
```json
{
"data": {
"pools": [
{
"pool_id": "fc9f488e-8183-416f-a61e-4e5c571d4395",
"symbol": "WETH-USDT",
"protocol": "uniswap-v3",
"chain": "Ethereum",
"apy": 31.53,
"apy_base": 31.53,
"apy_reward": 0,
"apy_mean_30d": 37.11,
"tvl_usd": 73909084,
"risk_grade": "B",
"risk_score": 74,
"prediction": "下降",
"stablecoin": false,
"il_risk": "yes",
"exposure": "multi"
},
{
"pool_id": "3dd2c646-c05a-4483-98f4-d7a924a6d6d3",
"symbol": "WBTC-USDT",
"protocol": "uniswap-v3",
"chain": "Ethereum",
"apy": 22.24,
"apy_base": 22.24,
"apy_reward": 0,
"apy_mean_30d": 21.92,
"tvl_usd": 16180215,
"risk_grade": "B",
"risk_score": 74,
"prediction": "下降",
"stablecoin": false,
"il_risk": "yes",
"exposure": "multi"
},
{
"pool_id": "49717ee2-9808-4288-b76d-e658195b7979",
"symbol": "USDC-WETH",
"protocol": "uniswap-v3",
"chain": "Ethereum",
"apy": 18.24,
"apy_base": 18.24,
"apy_reward": 0,
"apy_mean_30d": 20.65,
"tvl_usd": 23656801,
"risk_grade": "B",
"risk_score": 78,
"prediction": "下降",
"stablecoin": false,
"il_risk": "yes",
"exposure": "multi"
},
{
"pool_id": "0d9e7113-c9bc-4fb6-b138-5ca6f6944d6d",
"symbol": "SDCRV",
"protocol": "stake-dao",
"chain": "Ethereum",
"apy": 17.51,
"apy_base": 0,
"apy_reward": 17.51,
"apy_mean_30d": 16.61,
"tvl_usd": 26093458,
"risk_grade": "B",
"risk_score": 71,
"prediction": "下降",
"stablecoin": false,
"il_risk": "no",
"exposure": "single"
}
],
"total_matching": 146,
"total_scanned": 16642,
"filters_applied": {
"chain": "Ethereum",
"min_tvl": 10000000,
"min_apy": 3,
"max_risk": "B",
"limit": 5
}
},
"confidence": 0.92,
"data_freshness": "2026-04-12T02:31:10.638795+00:00",
"tool": "discover_yields",
"tier": "pro",
"powered_by": "profitspot.live"
}
```
</details>
**您获得：** 146 个以太坊池从 16,642 个扫描结果中匹配。每个池都经过风险评分（A-F），30 天平均 APY 和 APY 预测方向。按 APY 降序排列。
---
### 2. 风险评分 - Uniswap V3 池的深入分解
```
risk_score(pool_id="fc9f488e-8183-416f-a61e-4e5c571d4395")
```
<details>
<summary><strong>完整 JSON 响应</strong>（点击展开）</summary>
```json
{
"data": {
"type": "pool",
"pool_id": "fc9f488e-8183-416f-a61e-4e5c571d4395",
"symbol": "WETH-USDT",
"protocol": "uniswap-v3",
"chain": "Ethereum",
"grade": "B",
"score": 71,
"summary": "中等风险 - 坚实的基础，次要问题。适合多元化投资组合。",
"factors": {
"tvl_stability": {
"score": 20,
"max": 25,
"detail": "$73.9M TVL - 坚实"
},
"apy_sustainability": {
"score": 10,
"max": 20,
"detail": "31.5% APY - 中等 | 波动性：极端（CV=1.04)"
},
"protocol_reputation": {
"score": 20,
"max": 20,
"detail": "uniswap-v3 - 1 级蓝筹股（估计 48+ 个月)"
},
"il_exposure": {
"score": 8,
"max": 15,
"detail": "中等 IL - 监控价格差异"
},
"pair_stability": {
"score": 3,
"max": 10,
"detail": "非稳定币池 - 波动性"
},
"security_audit": {
"score": 10,
"max": 10,
"detail": "蓝筹股 + 深度 TVL - 高信心"
}
}
},
"confidence": 0.88,
"data_freshness": "2026-04-12T02:31:11.516026+00:00",
"tool": "risk_score",
"tier": "pro",
"powered_by": "profitspot.live"
}
```
</details>
**您获得：** 复合 **B 级评分（71/100）**，分为 6 个因素。池的协议声誉（Uniswap 是 1 级蓝筹股，成立 48+ 个月）和安全性方面得分完美，但因 APY 波动性（CV=1.04）和非稳定币对风险而扣分。AI 代理可以阅读此内容并准确解释 **池为何获得其评分**。
---
### 3. 无常损失 - ETH +50%， USDC -10%
```
calculate_impermanent_loss(token_a_price_change=50, token_b_price_change=-10, investment_amount=10000)
```
<details>
<summary><strong>完整 JSON 响应</strong>（点击展开）</summary>
```json
{
"data": {
"token_a_change_pct": 50.0,
"token_b_change_pct": -10.0,
"investment_amount": 10000.0,
"il_percent": 3.1754,
"il_usd": 381.05,
"value_if_held": 12000.0,
"value_in_lp": 11618.95,
"net_with_fees": {
"5%": {
"fees_earned": 500.0,
"net_gain_usd": 2118.95,
"net_roi_pct": 21.19
},
"10%": {
"fees_earned": 1000.0,
"net_gain_usd": 2618.95,
"net_roi_pct": 26.19
},
"20%": {
"fees_earned": 2000.0,
"net_gain_usd": 3618.95,
"net_roi_pct": 36.19
},
"50%": {
"fees_earned": 5000.0,
"net_gain_usd": 6618.95,
"net_roi_pct": 66.19
}
},
"interpretation": "中等无常损失 - 需要不错的 APY 来弥补。"
},
"confidence": 0.99,
"data_freshness": "2026-04-12T02:31:11.517000+00:00",
"tool": "calculate_impermanent_loss",
"tier": "pro",
"powered_by": "profitspot.live"
}
```
</details>
**您获得：** 仓位价值 10,000 美元的准确无常损失 **3.18% ($381)**。如果您持有代币，仓位价值为 12,000 美元，但在 LP 中价值为 11,619 美元。但这里的关键洞察是，在 5% 费用 APY 的情况下，您的净收益为 **+$2,119 (+21.2% ROI)**。该工具为 AI 代理提供了完整的图表，让其做出明智的建议。
---
## 📖 工具参考
通过 MCP 协议提供的所有 7 种工具：
### `discover_yields` 🟢 免费
> 跨 86 个链寻找最佳收益机会。过滤、风险评分和排名。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `chain` | `string \| null` | `null` | 按链名称过滤（例如 `"Ethereum"`、` "Arbitrum"`） |
| `min_tvl` | `float` | `1000000` | 最低 TVL（美元） |
| `min_apy` | `float` | `0` | 最低 APY 百分比 |
| `max_risk` | `string` | `"F"` | 最大风险等级：`A`、`B`、`C`、`D` 或 `F` *(仅限专业版)* |
| `limit` | `int` | `20` | 返回最大结果数（免费：10，专业版：50） |
---
### `analyze_pool` 🔒 专业版
> 对单个池进行深入分析：APY 趋势、风险分解、IL 场景、预测回报。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `pool_id` | `string` | *必填* | 从 `discover_yields` 结果的池 UUID |
**返回：** 历史 APY（7 天/30 天/90 天平均值）、趋势方向、波动率标准差、完整的风险评分分解、3 种差异情景下的 IL 估计值，以及 30/90/365 天内 1,000 美元/10,000 美元/100,000 美元的预测回报。
---
### `calculate_impermanent_loss` 🟢 始终免费
> 纯数学 - 任意 50/50 LP 币对的准确无常损失。无需 API 调用。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `token_a_price_change` | `float` | *必填* | 代币 A 的价格变化百分比（例如 `50` 代表 +50%） |
| `token_b_price_change` | `float` | *必填* | 代币 B 的价格变化百分比（例如 `-20` 代表 -20%） |
| `investment_amount` | `float` | `10000` | 初始投资金额（美元） |
**返回：** 无常损失（美元和 %），如果持有则价值 vs LP 中的价值，5%/10%/20%/50% 费用 APY 水平下的净收益/损失，以及易于理解的解释。
---
### `simulate_profit` 🔒 专业版
> 使用 Ornstein-Uhlenbeck APY 模型进行蒙特卡罗利润预测。1,000 次模拟。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `pool_id` | `string` | *必填* | 从 `discover_yields` 结果的池 UUID |
| `investment` | `float` | `10000` | 投资金额（美元） |
| `days` | `int` | `365` | 预测范围（1-730 天） |
| `compound` | `bool` | `true` | 是否每天复利 |
**返回：** 熊市/基准/乐观情景下的美元金额，完整的百分位分布（P5-P95），盈利概率，风险因素和模型参数。
---
### `risk_score` 🔒 专业版
> A-F 风险评分，适用于任何池或整个协议。6 因素加权分解。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `pool_id` | `string \| null` | `null` | 评分特定池 |
| `protocol` | `string \| null` | `null` | 评分整个协议（例如 `"aave-v3"`） |
至少需要一个参数。对于协议，评分前 10 个 TVL 最高的池并返回综合评分。
**6 因素：** TVL 稳定性（25 分）、APY 可持续性 + 波动性（20 分）、协议声誉 + 年龄（20 分）、IL 暴露（15 分）、对冲稳定性（10 分）、安全/审计代理（10 分）。
---
### `track_whales` 🔒 专业版
> 检测大额资本流动 - 智能资金流入或流出池。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `chain` | `string \| null` | `null` | 按链过滤 |
| `min_tvl_change` | `float` | `500000` | 触发的最小 TVL 变化（美元） |
| `timeframe` | `string` | `"24h"` | 检测窗口 |
**返回：** 具有大 TVL 变化的池列表、方向（流入/流出）、美元金额、百分比变化以及是否与 APY 变化相关。首次调用建立基线；后续调用检测实际变动。
---
### `defi_overview` 🟢 免费（基础）/ 专业版（完整）
> 跨所有链的 DeFi 大图景。
| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `chain` | `string \| null` | `null` | 过滤到特定链 |
**免费：** 总 TVL、十大链、十大协议、池数量、平均 APY。
**专业版：** + 按风险等级划分的平均收益、稳定币市值、热门机会（新池，APY 上升且风险评分良好）。
---
## 💰 定价
<table>
<tr>
<td align="center" width="33%">
### 🆓 免费
**$0/月**
3 种工具，每天 50 次调用
无需 API 密钥
</td>
<td align="center" width="33%">
### ⚡ 专业版
**$29/月**
所有 7 种工具，每天 1,000 次调用
[**→ 获取专业版**](https://buy.stripe.com/3cIaEZ0Gf1DrgQodvh4wM00)
</td>
<td align="center" width="33%">
### 🏢 企业版
**$99/月**
所有 7 种工具，每天 10,000 次调用
[**→ 获取企业版**](https://buy.stripe.com/7sY28t9cL81P8jS1Mz4wM01)
</td>
</tr>
</table>
| | 免费 | 专业版 ($29/月) | 企业版 ($99/月) |
|:---|:---:|:---:|:---:|
| `discover_yields` | ✅ 10 个结果 | ✅ 50 个结果 + 风险过滤器 | ✅ 50 个结果 + 风险过滤器 |
| `defi_overview` | ✅ 基础版 | ✅ 完整版 + 热门机会 | ✅ 完整版 + 热门机会 |
| `calculate_impermanent_loss` | ✅ | ✅ | ✅ |
| `analyze_pool` | ❌ | ✅ | ✅ |
| `simulate_profit` | ❌ | ✅ | ✅ |
| `risk_score` | ❌ | ✅ | ✅ |
| `track_whales` | ❌ | ✅ | ✅ |
| **每日限制** | 50 | 1,000 | 10,000 |
| **支持** | 社区 | 电子邮件 | 优先级 |
```bash
# 解锁专业版/企业版
export PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx
```
<p align="center">
<a href="https://buy.stripe.com/3cIaEZ0Gf1DrgQodvh4wM00"><strong>🚀 获取专业版 - $29/月</strong></a>
|
<a href="https://buy.stripe.com/7sY28t9cL81P8jS1Mz4wM01"><strong>🏢 获取企业版 - $99/月</strong></a>
|
<a href="https://profitspot.live/pricing"><strong>比较计划</strong></a>
</p>
---
## 🏠 自托管
### 选项 1：uvx（推荐）
```bash
uvx profitspot-mcp
```
零安装，直接运行。需要 [uv](https://docs.astral.sh/uv/)。
### 2：pip + 运行
```bash
pip install profitspot-mcp
profitspot-mcp # 标准输入输出（适用于 MCP 客户端）
python -m profitspot_mcp # HTTP/SSE 在 :8080
```
### 选项 3：Docker
```bash
docker build -t profitspot-mcp .
docker run -p 8080:8080 -e PROFITSPOT_API_KEY=您的密钥 profitspot-mcp
```
### 选项 4：从源码
```bash
git clone https://github.com/profitspot/profitspot-mcp.git
cd profitspot-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
# 开发并带有检查员 UI
fastmcp dev run_server.py
# 生产环境
fastmcp run run_server.py --transport sse --port 8080
```
---
## 🧠 内部原理
### 风险评级 - 6 因素综合评分
每个池根据 100 分的 6 个加权因素进行评分：
| 因素 | 权重 | 衡量内容 |
|--------|:------:|------------------|
| TVL 稳定性 | 25 分 | 流动性深度，rug 风险。100M+ = 满分。 |
| APY 可持续性 | 20 分 | 收益水平（是否现实）+ 波动性（历史数据标准差）。 |
| 协议声誉 | 20 分 | 1 级/2 级分类（Aave, Uniswap, Curve = 1 级）+ 估计年龄。 |
| IL 暴露 | 15 分 | 单一资产，稳定币对，或波动性 LP？ |
| 对冲稳定性 | 10 分 | 稳定币池检测以降低价格风险。 |
| 安全/审计代理 | 10 分 | 协议信任信号，来源于评级 + TVL 深度。 |
**评级：** A (85–100) · B (70–84) · C (55–69) · D (40–54) · F (0–39)
### 蒙特卡罗引擎 - 不只是 `APY × 天数`
`simulate_profit` 工具运行 **1,000 次模拟**，使用：
- **Ornstein-Uhlenbeck 过程** - APY 回复到长期均值（高 APY 池更快衰减）
- **几何布朗运动** - 模拟价格差异的无常损失
- **池失败事件** - 池死亡的概率，基于 TVL + APY 水平
- **APY 崩溃事件** - 随机制度变化，APY 下降 60-95%
返回真实美元金额，涵盖熊市/基准/乐观场景。
### 数据源
100% 由 [**DeFiLlama**](https://defillama.com/) API 提供 - 免费，无需密钥，无限次请求。涵盖 86+ 条链，6,500+ 个池，所有主要协议。
---
## 📄 许可证
[AGPL-3.0](LICENSE) - 免费使用、修改和分发。网络使用（作为服务运行）需要根据相同许可证共享您的修改。
---
<p align="center">
<strong>由 <a href="https://profitspot.live">ProfitSpot</a> 构建</strong><br/>
<sub>DeFi 的彭博终端 - 现已适用于所有 AI 代理。</sub>
</p>
---
<p align="center">
🔎 还要查看 <strong><a href="https://github.com/omniologynow-rgb/scout-intel-mcp">Scout Intel MCP</a></strong> - 适用于 AI 代理的商业和市场情报。几秒钟内研究任何公司，市场或竞争对手。
</p>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器