Philidor MCP

---

为什么选择 Philidor？

大多数 DeFi 数据工具只提供原始数据。Philidor 为你的 AI Agent 提供机构级风险情报。

功能	Philidor	DefiLlama MCP	通用 DeFi API
金库风险评分（0–10）	:white_check_mark:	:x:	:x:
风险向量分解	:white_check_mark:	:x:	:x:
金库比较	:white_check_mark:	:x:	:x:
管理者情报	:white_check_mark:	:x:	:x:
协议安全历史	:white_check_mark:	:x:	部分支持
尽职调查提示词	:white_check_mark:	:x:	:x:
投资组合风险评估	:white_check_mark:	:x:	:x:
无需 API 密钥	:white_check_mark:	:white_check_mark:	因情况而异
托管（零安装）	:white_check_mark:	:x:	:x:

---

快速开始

远程服务（推荐）

直接连接到托管服务 — 无需安装，始终保持最新：

https://mcp.philidor.io/api/mcp

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Claude Code

claude mcp add philidor --transport http https://mcp.philidor.io/api/mcp

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Windsurf

添加到 MCP 设置：

{
  "mcpServers": {
    "philidor": {
      "serverUrl": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Docker（stdio）

docker run -i --rm ghcr.io/philidor-labs/philidor-mcp

本地（stdio）

git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start

---

工具

提供 14 个工具，用于发现和分析金库、查询借贷市场、检查循环策略场所及研究协议。

search_vaults

按链、协议、资产、风险等级、TVL 等条件搜索和筛选 DeFi 金库。

参数	类型	描述
query	string	按金库名称、代币符号、资产、协议或管理者搜索
chain	string	按链名称或标识筛选（Ethereum、Base、Solana 等）
protocol	string	协议 ID：aave、morpho、spark、compound、yearn、beefy、uniswap、nest、maple、kamino
protocolVersion	string	按代际筛选（v3、v4 等）；与 protocol=aave 搭配使用可筛选 Aave V4
asset	string	按资产代币符号筛选（USDC、WETH 等）
riskTier	string	按风险等级筛选：Prime、Core 或 Edge
minTvl	number	TVL 最低值（美元）
depositable	boolean	按当前存款容量筛选
sortBy	string	排序字段：tvl_usd、apr_net、name、last_synced_at
sortOrder	string	排序顺序：asc 或 desc
limit	number	结果数量上限（默认 10，最多 50）

get_vault

获取特定金库的详细信息，包括风险分解、近期事件和历史快照。可通过 id 查询，也可通过 network + address 查询。

参数	类型	描述
id	string	金库 ID（例如 morpho-1-0x...）
network	string	网络标识（ethereum、base、arbitrum、solana）
address	string	金库地址（0x 十六进制地址或 Solana base58 地址）

get_vault_risk_breakdown

详细拆解金库的四个风险维度：资产构成、平台与策略、控制与治理、历史记录。

参数	类型	描述
network	string	网络标识符
address	string	金库地址

list_markets

列出借贷市场（Aave/Spark 池、Aave V4 spoke、Compound Comet、Morpho Blue 交易对、Kamino K-Lend）。共享流动性中心的 Aave V4 spoke 会归入组合中心父级（例如 aave-v4-1-hub-core）。

参数	类型	描述
protocol	string	aave、spark、compound、morpho、kamino
version	string	v3、v4 或 klend
chain	number/string	链 ID 或标识符
limit	number	1–100（默认值：20）
sortBy	string	total_supplied_usd、total_borrowed_usd、reserve_count、name

get_market

获取一个市场及其全部储备信息（供应量、供应 APR、借款量、借款 APR、利用率、等级）。接受 spoke ID 和组合中心 ID。

参数	类型	描述
marketId	string	list_markets 返回的市场 ID

get_market_events

获取某个借贷市场已发布的风险事件。中心 ID 会合并各 spoke 的事件源。

参数	类型	描述
marketId	string	list_markets 返回的市场 ID
limit	number	1–100（默认值：20）

check_loop_venue

评估某个市场上的抵押品/债务循环：分数、等级、利用率、借款 APR、存入状态，以及两项资产近期发生的事件。不计算健康因子，也不准备交易。

参数	类型	描述
marketId	string	list_markets 返回的市场 ID
collateral	string	抵押资产符号
debt	string	债务资产符号

compare_vaults

并排比较 2–3 个金库的 TVL、APR、风险分数、风险等级和审计状态。

参数	类型	描述
vaults	array	包含 2–3 个对象的数组，每个对象含有 network 和 address

find_safest_vaults

查找按 Philidor 风险分数排序的前 10 个已审计金库（分数越高 = 评估风险越低；不代表安全保证）。

参数	类型	描述
asset	string	按资产符号筛选
chain	string	按链名称筛选
minTvl	number	TVL 最低值（美元）

get_protocol_info

协议详情，包括 TVL、金库数量、版本、审计方、漏洞赏金和安全事件。

参数	类型	描述
protocolId	string	协议 ID（aave、morpho、spark、compound、yearn、beefy、uniswap、nest、maple、kamino）

get_curator_info

策展方详情，包括管理的金库、TVL、各链分布和绩效指标。

参数	类型	描述
curatorId	string	策展方 ID

get_market_overview

DeFi 金库市场的高级统计数据：总 TVL、金库数量、风险分布和按协议划分的 TVL。无需参数。

explain_risk_score

说明特定风险分数的含义，包括等级、计算方法和阈值。

参数	类型	描述
score	number	风险分数（0–10）

list_vaults_with_incidents

列出近期发生过严重事件的所有金库（过去 365 天）。按 TVL 降序排列，同等情况下按事件时间由近及远排序。无需参数。

---

资源

URI	描述
philidor://methodology	Vector Risk Framework v4.1 文档
philidor://supported-chains	支持的区块链网络及其金库数量
philidor://supported-protocols	支持的 DeFi 协议及其 TVL 数据

提示词

提示词	描述
vault_due_diligence	全面的金库尽职调查报告
portfolio_risk_assessment	跨持仓的投资组合级风险分析
defi_yield_comparison	收益率比较及风险调整分析
review_loop_venue	审查 Loop venue，然后移交给协议 MCP

---

提示词示例

连接后，试着向你的 AI 助手提问：

发现

"查找 TVL 至少为 $10M 的最安全 USDC 金库"

"Base 上有哪些 Morpho 金库？"

"展示 DeFi 市场概览"

分析

"对 Ethereum 上的 Steakhouse USDC 金库进行尽职调查"

"按风险评分比较排名前 3 的 USDC 金库"

"这个金库的风险细分是什么：ethereum/0x..."

投资组合

"评估我的投资组合：50% 投入 Morpho Steakhouse USDC，30% 投入 Aave USDC，20% 投入 Yearn USDC"

"哪些协议发生过安全事件？"

"8.5 的风险评分代表什么？"

---

风险评分

Philidor 使用 Vector Risk Framework v4.1，将金库风险分解为三个可衡量的向量：

Final Score = 40% Asset + 40% Platform + 20% Governance

资产构成（40%）

底层抵押品的质量。蓝筹资产（ETH、USDC）得分最高。考量因素包括预言机可靠性、流动性深度和锚定稳定性。

平台代码（40%）

代码成熟度的衡量因素：

• Lindy Score — 基于时间的安全性（>2 年 ≈ 9/10）
• 审计密度 — 审计的数量和质量
• 依赖风险 — 对高风险依赖项施加的乘数惩罚
• 事件惩罚 — 发生安全事件后设置的评分上限

治理（20%）

用户的退出窗口：

控制方式	评分
不可变合约	10/10
7 天或更长的时间锁	9/10
无时间锁	1/10

风险等级

等级	评分	含义
Prime	8.0–10.0	机构级 — 代码成熟、多次审计、治理安全
Core	5.0–7.9	安全性中等 — 经过审计，但较新或治理灵活
Edge	0.0–4.9	风险较高 — 需要谨慎尽职调查

---

架构

┌──────────────────┐     ┌─────────────────┐     ┌──────────────┐
│  Claude / Cursor  │────▶│  Philidor MCP   │────▶│ Philidor API │
│  Windsurf / etc.  │◀────│  Server         │◀────│              │
└──────────────────┘     └─────────────────┘     └──────┬───────┘
                          14 tools, 3 resources,         │
                          4 prompts                      │
                                                   ┌────▼────┐
                                                   │ On-chain │
                                                   │  data    │
                                                   └─────────┘

• 传输：Streamable HTTP（远程）或 stdio（本地/Docker）
• API：调用 Philidor Public API — 无需 API 密钥
• 无状态：每个请求都会启动全新的服务实例，不保留会话状态
• 数据：覆盖 Ethereum、Base、Arbitrum、Polygon、Optimism 和 Avalanche 的 700 多个金库

---

Cursor 市场插件

此仓库打包了一个 Cursor 插件，可将 Agent 连接到托管的 Philidor MCP 服务，并加载五个工作流技能。该插件不内置 API 密钥。Philidor 保持只读：它会为金库和借贷平台评分，但不会计算健康因子或准备交易。

该插件指向托管服务，其版本领先于此仓库中的 stdio 服务：

https://mcp.philidor.io/api/mcp

传输方式为 Streamable HTTP。对该 URL 执行实时 initialize 和 tools/list 会返回 14 个工具、3 个资源（philidor://methodology、philidor://supported-chains、philidor://supported-protocols）以及 4 个提示词（vault_due_diligence、portfolio_risk_assessment、defi_yield_comparison、review_loop_venue）。src/server.ts 注册了相同的 14 个工具。

项目	路径
清单	.cursor-plugin/plugin.json
市场索引	.cursor-plugin/marketplace.json（一个插件，来源为 .）
MCP 连接器	mcp.json
标志	assets/logo.svg（来自 philidor.io/brand-assets 的主兵标志）
技能	skills/vault-due-diligence、skills/pre-deposit-safety-check、skills/risk-adjusted-yield、skills/market-incident-monitoring、skills/philidor-api-handoff

产品页面：philidor.io/mcp。文档：MCP 服务、快速入门、工具、资源、提示词。

安装

插件上架后，在 Cursor 中打开 Customize，找到 Philidor，然后选择 Install（项目或用户范围）。这会同时加载技能和托管 MCP 服务。

在此之前，无需插件也可通过将以下内容添加到 .cursor/mcp.json 来连接同一服务：

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

若要从本地检出版本试用插件，请将此仓库复制到 ~/.cursor/plugins/local/philidor（该文件夹必须包含 .cursor-plugin/plugin.json），然后运行 Developer: Reload Window，并在 Customize 下确认技能和 MCP 服务。必须允许导入本地插件。同名的市场插件优先于本地副本。

示例提示词

• “对 Ethereum 上的 Gauntlet USDC 金库进行尽职调查。”
• “Ethereum 上哪些 Prime USDC 金库仍接受存款？它们的评分与 APR 相比如何？”
• “借款前，检查 Aave V4 Ethereum Main 上以 USDC 为抵押的 weETH 循环策略。”
• “列出按供应价值排名最大的 Aave V4 市场，以及我选定市场的近期事件。”
• “过去一年中，哪些金库发生过重大事故？”
• “我需要篮子成分和预言机数据新鲜度信息流。这些在免费 MCP 中提供，还是需要 API？”

技能会指导 Agent 从工具结果中复制金库 ID、网络 slug、地址和市场 ID，不要编造风险数值。循环策略检查会调用 check_loop_venue，然后停止。健康因子和未签名交易属于协议 MCP（Aave 的地址为 https://mcp.aave.com）。篮子、预言机向量、增强资产、事件流和 Risk Graph 穿透分析不包含在免费 MCP 中。philidor-api-handoff 技能会将这些问题引导至 API 访问与套餐 和定价，但不会引用价格。

提交检查清单

在审核者接受拉取请求之前，请勿从此 fork 提交。列表收录需在 cursor.com/marketplace/publish 手动审核。仓库必须公开。Cursor 会审核开源代码树及之后的每次更新。

• .cursor-plugin/plugin.json 可解析且符合 插件架构（name 为 philidor，采用小写 kebab-case）
• description 说明该插件是只读的金库和市场风险分析工具
• mcp.json 是唯一的 MCP 连接器，且不包含身份验证标头
• 每个技能目录都包含 SKILL.md，其 name 与文件夹名称一致，且 description 说明何时使用
• 已提交 assets/logo.svg，且 logo 的相对路径为 assets/logo.svg
• 清单路径均为相对路径且实际存在（skills/...、./mcp.json）。不得包含 .. 或绝对路径
• 不含 ${VAR} 占位符，因此 variables 保持未设置状态
• README（本节）说明了安装方式和提示词示例
• 实时检查：对 https://mcp.philidor.io/api/mcp 执行 initialize 和 tools/list 仍能成功
• 已在本地通过 ~/.cursor/plugins/local/philidor 测试（Customize 显示 5 个技能和 Philidor MCP 服务）
• 在 cursor.com/marketplace/publish 提交公开的 GitHub URL。此仓库是一个由 .cursor-plugin/marketplace.json 索引的单插件，source 为 "."

---

Agent 技能

通过 skills.sh 将 Philidor MCP 技能安装到你的编码 Agent：

npx skills add philidor-labs/philidor-mcp

这会让你的 Agent 全面了解所有工具、资源、提示词、推荐工作流，以及 DeFi 金库分析的最佳实践。

另有提供

接口	说明	链接
CLI	基于终端的金库智能分析 — 可编写脚本、可通过管道传递，并在 Agent 沙箱中运行	philidor-cli
OpenClaw Skill	面向 OpenClaw Agent 平台的技能定义	npm

---

支持的协议

Morpho、Aave（v3/v4）、Spark、Compound、Yearn、Beefy、Uniswap、Nest、Maple、Kamino — 并定期添加更多协议。

请在 app.philidor.io 查看完整列表。

---

开发

git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start

默认情况下，服务连接到 Philidor 公共 API。若要使用自定义端点：

PHILIDOR_API_URL=http://localhost:3003 npm start

---

链接

• Philidor MCP 介绍页 — 托管服务概览
• MCP 文档 — 工具、资源和提示词
• Philidor Analytics — 浏览金库和风险评分
• Philidor CLI — 基于终端的金库智能分析
• API 文档 — OpenAPI/Swagger 文档
• 风险方法论 — 评分的计算方式
• Smithery — MCP 服务注册表
• Twitter — 更新和公告

许可证

MIT