# @augustdigital/mcp 中文文档

规范地址：https://npmcn.com/package/%40augustdigital/mcp/

版本：0\.9\.16
npm 元数据更新时间：2026-10-28T14:18:05.457Z
中文译文更新时间：2026-11-07T04:50:20.833Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40augustdigital/mcp
原文对照：https://npmcn.com/package/%40augustdigital/mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：191 kB，69 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.23\.4 \<23\.0\.0 \|\| \>=24\.22\.1 \<25\.0\.0 \|\| \>=26\.12\.1
- 运行依赖：4 个
- 首次发布：2026-05-22T12:38:13.199Z
- 最新版本发布：2026-10-28T14:18:05.204Z
- 近 30 天下载量：2834（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：55（近 12 个月 55 个）

## 中文简介

本地stdio MCP服务器曝光"八月"数字SDK为"模型上下文协议"工具.

## 安装

```sh
npm install @augustdigital/mcp
```

也可以使用：`pnpm add @augustdigital/mcp`、`yarn add @augustdigital/mcp`、`bun add @augustdigital/mcp`

## README

# `@augustdigital/mcp`

本地标准 [示范背景协议](https://modelcontextprotocol.io/) 服务器将八月数字 SDK 读取的表面作为 MCP 工具,加 gitHub和Jira的帮助者。 共享其配置 `~/.augustdigital/` 与 [`@augustdigital/cli`](https://npmcn.com/package/%40augustdigital/cli),然后返回同样的 JSON 信封 - 工具结果 diff- clean 与匹配相对应 `august … --json` 输出.

没有链条写: 这里没有签名或广播交易 。 一个工具 创造一切 `jira_create_ticket`,它打开了 Jira 问题,当 Jira 证书配置(见 [一体化](https://npmcn.com/package/%40augustdigital/mcp/#readme-integrations)) (中文(简体) ).

## 工具

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问题存档.

每个工具结果 :

```json
{
  "schemaVersion": 1,
  "command": "vault.apy",
  "ok": true,
  "data": { "address": "0x…", "chainId": 8453, "currentApy": 0.1234 },
  "meta": { "chainId": 8453, "durationMs": 312, "generatedAt": "2026-05-17T…" }
}
```

## 安装

```sh
npm install -g @augustdigital/mcp
```

或不安装而引用:

```sh
npx -y @augustdigital/mcp
```

## 克劳德桌面

添加为 `~/Library/Application Support/Claude/claude_desktop_config.json`数字 :

```json
{
  "mcpServers": {
    "august": {
      "command": "npx",
      "args": ["-y", "@augustdigital/mcp"],
      "env": {
        "AUGUST_PASSPHRASE": "${env:AUGUST_PASSPHRASE}",
        "AUGUST_CONFIG_DIR": "${env:HOME}/.augustdigital"
      }
    }
  }
}
```

## 克劳德代码

```sh
claude mcp add august npx -y @augustdigital/mcp
```

## 认证

API 密钥解析度( 第一次点击获胜 ) :

1.  `AUGUST_API_KEY`
2.  活动会话——由 `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` 强迫它关闭 不论如何配置.

## 程序使用

```ts
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 :

```bash
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` 如果需要经过认证的工具的话.

克劳德代码连接 :

```bash
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`。 。 。 .

## 常见问题

### @augustdigital/mcp 是什么？

本地stdio MCP服务器曝光"八月"数字SDK为"模型上下文协议"工具\.

### 如何安装 @augustdigital/mcp？

在项目目录运行 npm install @augustdigital/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 august-mcp，可以用 npx august-mcp 直接运行。

### @augustdigital/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @augustdigital/mcp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @augustdigital/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.23\.4 \<23\.0\.0 \|\| \>=24\.22\.1 \<25\.0\.0 \|\| \>=26\.12\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @augustdigital/mcp 可以商用吗？

@augustdigital/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @augustdigital/mcp 的下载量有多少？

根据 npm 官方下载统计，@augustdigital/mcp 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,834 次，日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @augustdigital/mcp 还在维护吗？

最新版本 0\.9\.16 发布于 2026/10/28（10 天前）；至今共发布 55 个版本，其中过去 12 个月发布了 55 个；首次发布于 2026/05/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。