@augustdigital/mcp
本地标准 示范背景协议
服务器将八月数字 SDK 读取的表面作为 MCP 工具,加
gitHub和Jira的帮助者。 共享其配置
~/.augustdigital/ 与 @augustdigital/cli,然后返回同样的
JSON 信封 - 工具结果 diff- clean 与匹配相对应
august … --json 输出.
没有链条写: 这里没有签名或广播交易 。 一个工具
创造一切 jira_create_ticket,它打开了 Jira 问题,当
Jira 证书配置(见 一体化) (中文(简体) ).
工具
19个团体共有70个工具.
| 组 | 工具 |
|---|---|
| 元数据 | whoami, (中文(简体) ), chain_list, (中文(简体) ), rpc_test |
| 发现 | vault_list, (中文(简体) ), vault_search |
| 默认 | vault_get, (中文(简体) ), vault_apy, (中文(简体) ), vault_tvl, (中文(简体) ), vault_positions, (中文(简体) ), vault_loans, (中文(简体) ), vault_allocations, (中文(简体) ), vault_redemptions, (中文(简体) ), vault_history, (中文(简体) ), vault_summary |
| 用户 | user_points, (中文(简体) ), user_positions, (中文(简体) ), user_pnl |
| 数据 | points_leaderboard, (中文(简体) ), vault_pending_redemptions, (中文(简体) ), vault_pnl_history, (中文(简体) ), pnl_latest |
| 活动 | vault_activity, (中文(简体) ), activity_ranking, (中文(简体) ), user_activity, (中文(简体) ), user_transfers |
| 读取 | total_deposited, (中文(简体) ), token_price, (中文(简体) ), vault_withdrawals, (中文(简体) ), vault_pnl, (中文(简体) ), vault_annualized_apy, (中文(简体) ), withdrawal_requests_status |
| 子账户 | subaccount_list, (中文(简体) ), subaccount_summary, (中文(简体) ), subaccount_health_factor, (中文(简体) ), subaccount_loans, (中文(简体) ), subaccount_cefi_positions, (中文(简体) ), subaccount_otc_positions, (中文(简体) ), subaccount_transactions, (中文(简体) ), subaccount_loan_by_address, (中文(简体) ), subaccount_debank |
| 风险 | dashboard_loans, (中文(简体) ), risk_discount_factors, (中文(简体) ), risk_collateral_excess, (中文(简体) ), risk_collateral_simulate |
| 曲线 | tx_revert_reason |
| 解码 | decode_revert_data, (中文(简体) ), simulate_call, (中文(简体) ), read_token_state |
| OTC 东方木材公司 | otc_positions_list, (中文(简体) ), otc_margin_requirements |
| 监视器 | curator_vault_subaccounts, (中文(简体) ), curator_vault_whitelist |
| 施政 | timelock_requests_list, (中文(简体) ), vault_performance_fees, (中文(简体) ), vault_oracle_classification |
| 行动 | ops_health, (中文(简体) ), ops_redemptions |
| 层零 | layerzero_deposits, (中文(简体) ), layerzero_redeems |
| 文档 | docs_search, (中文(简体) ), docs_fetch, (中文(简体) ), docs_list |
| GitHub 图像 | github_list_repos, (中文(简体) ), github_get_file, (中文(简体) ), github_search_code, (中文(简体) ), github_list_prs, (中文(简体) ), github_get_pr, (中文(简体) ), github_list_issues |
| 贾拉 | jira_create_ticket, (中文(简体) ), jira_list_projects |
活动 回答流动问题—— vault_activity 返回金库的存款/提取
feed+计算汇总(计数、量、净流量),以及 activity_ranking 排名金库
上星期的存款最多) 大多数金库/用户
工具镜像 an august … CLI 命令; subaccount_* 财务报告和审定财务报表 layerzero_* 读取体制
和交叉链面.
线程/ 解码 工作来自错误而不是地址—— tx_revert_reason 跟踪 a
地雷交易散列物; decode_revert_data 解码原始回转blob或整个醚错误
不存在散列时的字符串( 估计 Gas / eth call 失败); simulate_call 重播一个调用
取回被截断的还原数据; read_token_state 读取 ERC-20 持有者的余额,
备忘,以及用于区分用户错误和冻结的发行者遵守标记.
文档 / GitHub / Jira 支持相同的分解循环:搜索并获取八月和 临时文件,读取来源 并调取8月 GitHub 组织的请求, 并将结果作为Jira问题存档.
每个工具结果 :
{
"schemaVersion": 1,
"command": "vault.apy",
"ok": true,
"data": { "address": "0x…", "chainId": 8453, "currentApy": 0.1234 },
"meta": { "chainId": 8453, "durationMs": 312, "generatedAt": "2026-05-17T…" }
}
安装
npm install -g @augustdigital/mcp
或不安装而引用:
npx -y @augustdigital/mcp
克劳德桌面
添加为 ~/Library/Application Support/Claude/claude_desktop_config.json数字 :
{
"mcpServers": {
"august": {
"command": "npx",
"args": ["-y", "@augustdigital/mcp"],
"env": {
"AUGUST_PASSPHRASE": "${env:AUGUST_PASSPHRASE}",
"AUGUST_CONFIG_DIR": "${env:HOME}/.augustdigital"
}
}
}
}
克劳德代码
claude mcp add august npx -y @augustdigital/mcp
认证
API 密钥解析度( 第一次点击获胜 ) :
AUGUST_API_KEY- 活动会话——由
august login或自动解锁AUGUST_PASSPHRASE在服务器启动时.
当两者均不存在时——或后端拒绝密钥——认证的工具返回 code: "API_KEY_MISSING"
有补救提示。 公共阅读方法仍然有效.
一体化
GitHub 和 Jira 团体与外部服务交谈,直到 其全权证书存在于环境中:
| 组 | 环境 | 没有它 |
|---|---|---|
| GitHub 图像 | AUGUST_GITHUB_TOKEN ——8月组织可阅读的标志 | 工具返回给变量命名的错误信封 |
| 贾拉 | JIRA_BASE_URL, (中文(简体) ), JIRA_USER_EMAIL, (中文(简体) ), JIRA_API_TOKEN, (中文(简体) ), JIRA_PROJECT_KEY; 加上活动时间为 jira_create_ticket | 工具返回一个命名变量的错误信封 |
遥测
服务器重用 SDK 的 Sentry 遥测并遵循共享
telemetry 设置在 ~/.augustdigital/config.json 默认关闭
之后 august init (当你接受提示)或
august config set telemetry true打开时, SDK 错误和工具失败
报告除配置问题外的其他问题 sdk.surface: mcp 财务报告和审定财务报表
app.name: august-mcp,每个后端请求都带有
x-august-app: august-mcp。 。 。 . AUGUST_SDK_DISABLE_ANALYTICS=1 强迫它关闭
不论如何配置.
程序使用
import { buildServer, bootstrap } from '@augustdigital/mcp';
await bootstrap();
const server = buildServer();
// attach your own transport (e.g. an in-memory pair for testing)
运输
Stdio是默认的(shown in the quickstart). 对于一个共享的例子,运行 可流 HTTP :
AUGUST_MCP_TOKEN=<team-token> august-mcp --http --port 8787
- 终点 :
POST/GET http://<host>:8787/mcp - 每个请求都必须发出
Authorization: Bearer <team-token>; 其他任何东西 得到一个401. - 服务器绑定
127.0.0.1除非AUGUST_MCP_HOST说不然. - 无国籍模式: 在负载平衡器后面不需要会话亲和 .
- 表面与stdio相同(同为工具、资源、提示和
JSON信封). 没有在 HTTP 模式下读取密钥—— 提供
AUGUST_API_KEY如果需要经过认证的工具的话.
克劳德代码连接 :
claude mcp add --transport http august http://<host>:8787/mcp \
--header "Authorization: Bearer <team-token>"
资源提示( T)
- 资源:
august://chains, (中文(简体) ),august://errors, (中文(简体) ),august://vaults/{chainId}(使用时0所有链条). - 提示 :
analyze-vault-health, (中文(简体) ),compare-vaults, (中文(简体) ),explain-user-position。 。 。 .