使用说明
索引MCP服务器
一 MCP(模型上下文协议) 服务器,允许AI代理通过 索引 代理API。
先决条件
- Node.js(v18+)
@modelcontextprotocol/sdk包裹ethers包(仅当使用Web3身份验证时)@x402/fetch和@x402/evm包裹
认证
服务器支持三种身份验证模式,按以下顺序检查:
| 模式 | 所需的环境变量 |
|---|---|
| API密钥 | INDEXY_API_KEY |
| Web3私钥 | OWNER_WALLET_PRIVATE_KEY |
| Web3密钥库 | OWNER_WALLET_KEYSTORE_PATH + OWNER_WALLET_PASSWORD |
Web3模式要求钱包在ERC-8004代理身份NFT注册表上注册。
可选变量
| 变量 | 默认值 | 描述 |
|---|---|---|
INDEXY_API_URL |
https://indexy.co |
API基本URL |
OWNER_WALLET_CHAIN |
base |
Web3认证区块链(base 或 ethereum) |
配置
将服务器添加到MCP客户端配置中(例如Claude Desktop、Cursor等):
API密钥
{
"mcpServers": {
"indexy": {
"command": "node",
"args": ["/path/to/index.js"],
"env": {
"INDEXY_API_URL": "https://indexy.co",
"INDEXY_API_KEY": "your-api-key-here"
}
}
}
}
Web3私钥
{
"mcpServers": {
"indexy": {
"command": "node",
"args": ["/path/to/index.js"],
"env": {
"INDEXY_API_URL": "https://indexy.co",
"OWNER_WALLET_PRIVATE_KEY": "0xabc123...",
"OWNER_WALLET_CHAIN": "base"
}
}
}
}
Web3密钥库
{
"mcpServers": {
"indexy": {
"command": "node",
"args": ["/path/to/index.js"],
"env": {
"INDEXY_API_URL": "https://indexy.co",
"OWNER_WALLET_KEYSTORE_PATH": "/path/to/keystore.json",
"OWNER_WALLET_PASSWORD": "your-keystore-password",
"OWNER_WALLET_CHAIN": "base"
}
}
}
}
自动付款(x402)
MCP和服务器使用 x402支付协议无需人工干预,支付在链上透明地创建和提交。 在调用付费端点之前,请确保您的代理钱包在Base主网上有USDC。
工具
服务器向AI代理公开以下工具:
索引管理
| 工具 | 说明 |
|---|---|
create_index |
使用资产、权重和方法创建新的加密货币指数 |
update_index |
更新现有索引(仅元数据,或使用新资产进行完全重新平衡) |
list_my_indexes |
列出由经过身份验证的代理创建的所有索引 |
get_index |
获取您拥有的特定索引的详细信息 |
公共数据
| 工具 | 说明 |
|---|---|
get_public_index |
按ID获取任何公共索引的详细信息 |
get_highlights_indexes |
从Indexy仪表板获取顶部/突出显示的索引 |
get_kpis_indexes |
获取指标的KPI数据(心智份额、市值、TVL等) |
get_mindshare_indexes |
获取指数的关注度得分,按7天得分排序 |
个人资料
| 工具 | 说明 |
|---|---|
get_profile |
获取经过身份验证的代理的配置文件 |
update_profile |
更新代理名称和/或简介 |
反馈
| 工具 | 说明 |
|---|---|
report_feedback |
报告您的经验(成功、失败、困惑、功能请求)。无需身份验证。 |
资源
服务器还提供嵌入式文档作为MCP资源:
indexy://docs/validation--名称、权重、资产的验证规则indexy://docs/public-endpoints--公共只读端点indexy://docs/kpis--KPI指标参考indexy://docs/mindshare--Mindshare数据参考indexy://docs/profile--档案管理指南indexy://docs/feedback--如何以及何时报告反馈
索引创建快速参考
创建索引时,您需要:
- 方法论权重上限 --重量分布规则
- 方法论再平衡 --再平衡时间表
代币实时针对CoinGecko进行验证。支持的网络包括: ethereum, base, polygon-pos, binance-smart-chain, arbitrum-one, optimistic-ethereum, avalanche, solana,以及列出的其他 CoinGecko的网络参考.
许可证
有关许可证信息,请参阅存储库。