内容
# 维基趣 MCP 服务器
将任何支持 MCP 的 AI 助手（Claude Desktop，Claude Code，Cursor，
VS Code Copilot，Windsurf，Kiro）直接连接到 Arbitrum One 上的维基趣 V6 协议。
## 功能
安装后，您可以询问 Claude（或任何 MCP 客户端）：
- *"维基趣上有哪些活跃的永续市场及其当前价格？*
- *"显示钱包 0x... 的所有开放仓位。*
- *"ETH/USD 的资金费率是多少？*
- *"当前的质押年化收益率和我的 veWIK 余额是多少？*
- *"以 200 美元抵押品开仓 ETH/USD 5 倍多头，止损价为 2900 美元，目标价为 3200 美元。*
- *"分析钱包 0x... 的整个维基趣投资组合。*
- *"协议的月收入是多少？*
## 可用工具
### 只读（无需私钥）
| 工具 | 描述 |
|---|---|
| `wikicious_get_markets` | 所有活跃的永续市场 + 标记价格 |
| `wikicious_get_price` | 任意市场的预言机价格 |
| `wikicious_get_vault_balance` | 钱包的 USDC 金库余额 |
| `wikicious_get_positions` | 钱包的所有开放永续仓位 |
| `wikicious_get_position` | 特定仓位，包含链上 PnL |
| `wikicious_get_funding_rate` | 资金费率 + OI 不平衡 |
| `wikicious_get_lending_rates` | 借贷市场的供应/借贷年化收益率 |
| `wikicious_get_lending_position` | 用户的借贷仓位 |
| `wikicious_get_staking_info` | 质押锁定，veWIK，可领取费用 |
| `wikicious_get_amm_stats` | WikiAMM AUM + WLP 价格 |
| `wikicious_get_wik_balance` | WIK 代币余额 |
| `wikicious_get_revenue_stats` | 协议月度费用 + 收入分成 |
| `wikicious_get_protocol_summary` | 完整的协议健康状况快照 |
### 写入（需要 `.env` 中的 `WALLET_PRIVATE_KEY`）
| 工具 | 描述 |
|---|---|
| `wikicious_open_position` | 开仓永续仓位，包含止盈止损 |
| `wikicious_close_position` | 关闭开放仓位 |
| `wikicious_deposit_vault` | 存入 USDC 到 WikiVault |
| `wikicious_withdraw_vault` | 从 WikiVault 提取 USDC |
| `wikicious_stake_wik` | 质押 WIK，附带锁定时间 |
| `wikicious_claim_staking_fees` | 领取 USDC 费用奖励 |
## 安装
### 1. 安装
```bash
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env：添加您的 ARBITRUM_RPC_URL（和 WALLET_PRIVATE_KEY 以使用写入工具）
```
为了获得更快的 RPC（推荐）：
```bash
ARBITRUM_RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY
```
### 2. 测试
```bash
python server.py stdio
# 在另一个终端：
npx @modelcontextprotocol/inspector python server.py stdio
```
### 3. 添加到 Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）
或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"wikicious": {
"command": "python",
"args": ["/absolute/path/to/wikicious_mcp/server.py", "stdio"],
"env": {
"ARBITRUM_RPC_URL": "https://arb1.arbitrum.io/rpc",
"WALLET_PRIVATE_KEY": "optional_for_write_tools"
}
}
}
}
```
重启 Claude Desktop。您将在工具列表中看到“wikicious”。
### 4. 添加到 Claude Code
```bash
claude mcp add wikicious python /absolute/path/to/wikicious_mcp/server.py stdio
```
### 5. 添加到 Cursor / VS Code / Windsurf
将以下内容添加到您的 MCP 设置文件（因 IDE 而异）：
```json
{
"wikicious": {
"command": "python",
"args": ["/absolute/path/to/wikicious_mcp/server.py", "stdio"]
}
}
```
## 安全
- 只读工具不需要私钥 — 可以安全地与任何钱包地址一起使用
- 写入工具需要 `WALLET_PRIVATE_KEY` — 使用专用的交易钱包，
而不是您的主要金库
- MCP 服务器在您的机器上本地运行 — 私钥不会离开您的计算机
- 永远不要将 `.env` 提交到 git
## 合约地址（Arbitrum One 主网）
| 合约 | 地址 |
|---|---|
| WikiPerp | `0x723f653a3DEFC45FB934BBF81f1411883a977468` |
| WikiVault | `0x4533E181FdF5b0C66e0816992F38c23d57e42Df8` |
| WikiOracle | `0xA99583D3cd272F95b8f08b32297f072f5164D0DC` |
| WikiStaking | `0xDD551D705fAbD4380D2C95F7345b671cE3310bd2` |
| WikiAMM | `0x5e73fa11c2Fa157dbE59E7B8F7f1b3101c5c6004` |
| WikiLending | `0x74635CFa33EEAe220367fF10C598e098a29e9246` |
| WIK 代币 | `0xa681Bf6f0449ABc4E98DCa3468488Fe1b24FdD0F` |
