402 AI MCP

MCP金融服务

提供方 402ai-net

金融服务 未标注 Token 社区 / 第三方

MCP (Model Context Protocol) 服务器,为402ai.net提供闪电网络支付的API代理服务,支持目录感知工具、Bearer优先认证和动态工具刷新通知。

一句话选型结论

按资料字段整理

402 AI MCP 属于金融服务类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类金融服务 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 21 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

金融服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量21暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

API代理TypeScript本地部署闪电网络支付目录同步Bearer认证动态工具更新

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 21 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
行情与财务数据

查行情、财报、汇率等金融数据。

支付与账务查询

查订单、账单与交易流水。

风控与核验

做身份、信用与风险信息核验。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 21 个工具,覆盖面较广,能满足多种调用。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在金融服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
402 AI MCP当前 21 未标注 未标注 无 2026-05-17
Alpaca MCP 62 stdio · 本地进程 支持远程部署 有 2026-05-18
OpenNews MCP 11 stdio · 本地进程 支持远程部署 有 2026-05-17
MCP Server 273df76d 未标注 stdio · 本地进程 本地部署 有 2026-05-17
tradingview-mcp 未标注 stdio · 本地进程 本地部署 有 2026-04-19
goat (Goat SDK) 未标注 未标注 未标注 无 2026-05-17

服务器档案

金融服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方402ai-net上游标注的维护方 402ai-net
分类金融服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.2 KB
来自项目仓库与上游目录的原文,未做删改

402ai mcp

MCP(模型上下文协议)服务器 402ai.net -Lightning-paid API代理。提供具有紧凑/完整配置文件、承载者优先身份验证和动态工具刷新通知的目录感知工具。

当功能发生变化时,请更新我。

特性

  • 两种工具配置文件:紧凑型(针对代理进行了优化)或全型(全面的端点覆盖)
  • 目录同步:自动跟踪API目录更改
  • 承载令牌认证:对预付余额代币的一流支持
  • 动态工具更新:通过MCP通知在目录更改时通知客户端
  • 智能整合:紧凑型轮廓合并重叠的端点,以减少工具混乱
  • TypeScript原生:具有类型安全的完整TypeScript实现
  • 全面测试:目录验证、重复数据删除、HTTP处理和多部分上传的单元测试

快速开始

安装```bash

npm install
npm run build
npm test


### 通过stdio运行```bash
ALBOM_BEARER_TOKEN= npm start

NPM包```bash

npm install 402ai-mcp


## 配置

通过环境变量进行配置:

|变量|默认值|描述|
|----------|---------|-------------|
| `ALBOM_BASE_URL` | `https://402ai.net` |API基本URL|
| `ALBOM_BEARER_TOKEN` | _(无)_ |预付余额代币(强烈推荐)|
| `ALBOM_NWC_URI` | _(无)_ |客户端NWC连接URI用于在本地自动支付充值发票|
| `ALBOM_NWC_THRESHOLD_SATS` | `1000` |当API响应报告余额低于此阈值时触发自动关闭|
| `ALBOM_NWC_TOPUP_USD` | `2.00` |每次自动充值的美元金额|
| `ALBOM_NWC_MAX_DAILY` | `10.00` |MCP客户端将在24小时滚动窗口内自动充值的最大美元数|
| `ALBOM_TOOL_PROFILE` | `compact` |刀具轮廓: `compact` 或 `full` |
| `ALBOM_INCLUDE_MODERATION` | `false` (紧凑型), `true` (完整)|包括审核工具|
| `ALBOM_INCLUDE_EMBEDDINGS` | `false` (紧凑型), `true` (完整)|包括嵌入工具|
| `ALBOM_INCLUDE_VIDEO` | `true` |包括视频生成工具|
| `ALBOM_ALLOW_RAW_TOOL` | `false` |暴露 `albom_raw_call` 工具(仅限完整配置文件)|
| `ALBOM_CATALOG_TTL_MS` | `300000` (5分钟)|目录缓存TTL|
| `ALBOM_HTTP_TIMEOUT_MS` | `90000` (90秒)|HTTP请求超时|
| `ALBOM_MAX_RETRIES` | `2` |失败请求的最大重试次数|
| `ALBOM_MAX_UPLOAD_BYTES` | `26214400` (25 MB)|最大上传文件大小|

## 工具配置文件

### 紧凑型配置文件(默认)

针对AI代理进行了优化,工具模糊性最小。将重叠的端点整合到语义工具中:

|工具|目的|映射到端点|
|------|---------|------------------|
| `albom_catalog_get` |获取实时API目录| `/api/v1/catalog` |
| `albom_text_generate` |生成文本补全| `/v1/responses` |
| `albom_image_generate` |生成图像| `/v1/images/generations` |
| `albom_image_edit` |编辑图像| `/v1/images/edits` |
| `albom_audio_speech` |生成语音| `/v1/audio/speech` |
| `albom_video_generate` |生成视频(如果启用)| `/v1/video/generations` |
| `albom_safety_moderate` |内容审核(如果启用)| `/v1/moderations` |
| `albom_embedding_create` |创建嵌入(如果启用)| `/v1/embeddings` |

**整合**:

- 隐藏 `/v1/chat/completions` 支持 `/v1/responses` (相同的模型集)

### 完整剖面

每个目录端点一个工具,实现全面覆盖:

- `albom_openai_chat_completions`
- `albom_openai_responses`
- `albom_openai_images_generations`
- `albom_openai_images_edits`
- `albom_openai_images_variations`
- `albom_openai_audio_speech`
- `albom_openai_audio_transcriptions`
- `albom_openai_embeddings`
- `albom_openai_moderations`
- `albom_openai_video_generations`
- `albom_catalog_get`
- `albom_raw_call` (如果 `ALBOM_ALLOW_RAW_TOOL=true`)

## 认证

### 承载令牌(推荐)

集 `ALBOM_BEARER_TOKEN` 您的预付余额代币。所有请求都将使用 `Authorization: Bearer `.

**获取令牌**:```bash
# 1. Create topup invoice
curl -X POST https://402ai.net/api/v1/topup \
-H "Content-Type: application/json" \
-d '{"amount_sats":1000}'

# 2. Pay invoice with Lightning wallet, then claim
curl -X POST https://402ai.net/api/v1/topup/claim \
-H "Content-Type: application/json" \
-d '{"preimage":""}'

NWC汽车加油

集 ALBOM_NWC_URI 到一个 nostr+walletconnect://... URI,让MCP客户端在本地自动支付充值发票。NWC秘密保留在MCP客户端进程中,永远不会发送到402ai服务器。

当工具响应包括 balance_sats 或 available_sats 在......下面 ALBOM_NWC_THRESHOLD_SATS,MCP客户端将:

  1. POST /api/v1/topup 随着 {"amount_usd": ALBOM_NWC_TOPUP_USD}
  2. 通过NWC支付退回的发票 pay_invoice
  3. POST /api/v1/topup/claim 返回的原图
  4. 如果声明返回较新的令牌,则更新内存中的承载令牌

笔记:

  • 自动充值仅适用于客户端。NWC URI永远不会触及402ai服务器。
  • ALBOM_NWC_MAX_DAILY 是自动充值的24小时滚动美元支出上限。
  • 自动充值本身不会引导一个全新的帐户。以有效开头 ALBOM_BEARER_TOKEN,那么NWC可以保持资金平衡。

无令牌(L402流)

如果没有令牌,调用将返回 402 Payment Required 持有闪电发票。MCP服务器将在付款详细信息中显示此错误。

用法示例

使用克劳德桌面

添加 claude_desktop_config.json:```json
{
"mcpServers": {
"402ai": {
"command": "node",
"args": ["/path/to/402ai-mcp/dist/server.js"],
"env": {
"ALBOM_BEARER_TOKEN": "abl_your_token_here",
"ALBOM_NWC_URI": "nostr+walletconnect://...",
"ALBOM_NWC_THRESHOLD_SATS": "1000",
"ALBOM_NWC_TOPUP_USD": "2.00",
"ALBOM_NWC_MAX_DAILY": "10.00",
"ALBOM_TOOL_PROFILE": "compact"
}
}
}
}


### 编程式用法```typescript
import { createAlbomServer } from '402ai-mcp';

const server = createAlbomServer({
baseUrl: 'https://402ai.net',
bearerToken: process.env.ALBOM_BEARER_TOKEN,
toolProfile: 'compact'
});

// Start server
await server.run();

发展

构建```bash

npm run build


## 文件编制纪律

保持 `ARCHITECTURE.md` 和 `WORKLOG.md` 当工具行为、传输假设、身份验证流或部署期望发生变化时,准确无误。

### 测试```bash
npm test              # Run all tests
npm run test:watch    # Watch mode

开发服务器```bash

npm run dev # Watch and rebuild
npm run start:dev # Run without build


### 烟雾测试(现场API)```bash
ALBOM_BEARER_TOKEN= npm run smoke:live

建筑

核心模块

  • catalog.ts:获取并验证 /api/v1/catalog,检测更改
  • config.ts:环境变量配置和验证
  • dedup.ts:模型集重复数据删除逻辑(Jaccard相似性)
  • httpClient.ts:具有重试逻辑、多部分支持、承载身份验证的HTTP客户端
  • tools/:用于紧凑和完整配置文件的工具实现
  • results.ts:响应规范化和错误处理
  • uploads.ts:文件上传处理(路径和base64)
  • server.ts:MCP服务器实现

目录同步

  1. 获取 /api/v1/catalog 启动时
  2. 缓存 ALBOM_CATALOG_TTL_MS
  3. 定期刷新和比较
  4. 发送 notifications/tools/list_changed 如果目录更改
  5. 客户端重新获取工具定义

错误处理

HTTP错误被标准化为MCP友好格式:

  • 402 Payment Required:返回付款详细信息(发票、金额、到期日_in)
  • 400 Bad Request:返回验证错误
  • 429 Rate Limited:返回信息后重试
  • 5xx Server Error:返回错误消息
  • 网络错误:指数回退自动重试

测试

测试套件包括:

  • 目录验证和规范化
  • 模型集重复数据删除(Jaccard相似性)
  • HTTP错误规范化
  • 多部分上传编码(路径+base64)
  • 刀具列表更改检测
  • 承载令牌身份验证
  • 重试逻辑

运行测试:```bash
npm test


## 出版```bash
# 1. Build and test
npm run build
npm test

# 2. Check package contents
npm pack --dry-run

# 3. Publish
npm login
npm version patch  # or minor/major
npm publish --access public

项目结构```

.
├── src/
│ ├── catalog.ts # Catalog fetching and tracking
│ ├── config.ts # Environment configuration
│ ├── dedup.ts # Model set deduplication
│ ├── httpClient.ts # HTTP client with retries
│ ├── server.ts # MCP server implementation
│ ├── tools/ # Tool implementations
│ │ ├── compact.ts # Compact profile tools
│ │ ├── full.ts # Full profile tools
│ │ └── shared.ts # Shared tool utilities
│ ├── results.ts # Response normalization
│ ├── uploads.ts # File upload handling
│ ├── types.ts # TypeScript types
│ └── index.ts # Public exports
├── test/ # Test suite
├── scripts/ # Utility scripts
├── dist/ # Compiled output
└── 402AI_MCP_IMPLEMENTATION_SPEC.md # Design spec

Documentation:
└── 402AI_MCP_IMPLEMENTATION_SPEC.md
```

MCP规范

此服务器实现 MCP规范修订版2025-11-25.

支持的功能:

  • 工具能力
  • 通知功能(tools/list_changed)
  • 工具注释(title, readOnlyHint, idempotentHint)
  • stdio传输

许可证

MIT-请参阅许可证文件。

贡献

有关最近的更改和发展历史,请参阅WORKLOG.md。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
402 AI MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

402 AI MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

402 AI MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

402 AI MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

402 AI MCP 能提供哪些能力?

资料显示约 21 个工具;能力标签包括 API代理、TypeScript、金融数据。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。