mcpField
B
Basis Protocol

Basis Protocol

本地服务
github.com/shlok-lgtm金融数据028 周前更新

关于 Basis Protocol

Basis Protocol MCP 是面向稳定币、钱包和交易风险评估的 MCP 服务套件,供需要读取风险分数的客户端集成。README 标明旧版单体服务已弃用,推荐使用四个分领域服务;目前所有旧工具均在 oracle 服务中。

主要功能

  1. 01读取 SII、PSI、RPI 等分数
  2. 02CQI 组成与压力评估
  3. 03提供合规报告及传染分析
  4. 04证据与实时信号服务框架

适用场景

  1. 01在客户端读取稳定币相关风险分数
  2. 02获取钱包或交易风险信息
  3. 03基于 CQI 和相关指标开展风险分析

MCP 相关

向 MCP 客户端提供风险分数读取工具。拆分后的其他三个服务目前作为脚手架保留命名空间,功能尚在交付中。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"shlok-lgtm-basis": {
"command": "npx",
"args": [
"-y",
"@basis-protocol/mcp-server"
]
}
}
}
启动命令npx -y @basis-protocol/mcp-server

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@basis-protocol/mcp-server1.0.3

工具

8

收录的工具列表 · 更新于 3 周前

参数类型必填说明
sort_byenum否结果的排序顺序score_desc | score_asc | name
min_gradeenum否可选的最低评级筛选条件(例如,'B+' 将返回 B+ 及以上的评级)A+ | A | A- | B+ | B | B- | C+ | C | C- | D | F

详细介绍

Basis Protocol MCP — 拆分服务

2026-04-19: 单体版 @basis-protocol/mcp-server (注册表名称为 io.github.basis-protocol/basis-mcp)已弃用, 但仍在发布且可正常使用。新集成应安装以下四个独立服务。目前全部 8 个 旧版工具均已在 @basis/oracle-mcp 中发布;其他三个服务将保留各自的 命名空间,并在功能集推出期间以脚手架形式发布。

PackageScopeSource
@basis/oracle-mcp评分读取 — SII、PSI、RPI、累积指数packages/oracle-mcp
@basis/cqi-mcp组合分析 — CQI 对、压力、Basel SCO60 / MiCA / GENIUS 报告、RQS、传染性packages/cqi-mcp
@basis/witness-mcp证据 — 证明、TLSNotary 证明、CDA 快照packages/witness-mcp
@basis/divergence-mcp实时信号 — 脉冲、分歧、预言机压力、一致性下降、发现packages/divergence-mcp

共享 HTTP 客户端、类型、辅助工具和服务运行器位于 @basis/mcp-shared。旧版单体位于 artifacts/basis-mcp。完整拆分记录请参阅 mcp_split_plan.md、 mcp_registry_entries.md 和 blockers.md。


MCP 注册表

MCP 注册表为 MCP 客户端提供 MCP 服务列表,可视为 MCP 服务的应用商店。

📤 发布我的 MCP 服务 | ⚡️ 实时 API 文档 | 👀 生态愿景 | 📖 完整文档

开发状态

2025-10-24 更新:注册表 API 已进入 API 冻结期(v0.1) 🎉。未来一个月或更长时间内,API 将保持稳定,不会有破坏性变更,让集成方能够放心地实现支持。此冻结适用于 v0.1,同时 v0 的开发仍在继续。我们将利用这段时间在实际集成中验证 API,并收集反馈,以完善面向正式发布的 v1。感谢大家的贡献与耐心——正是你们的参与让我们走到了今天!

2025-09-08 更新:注册表已启动预览版 🎉(公告博客文章)。虽然系统现在更加稳定,但这仍是预览版,可能会发生破坏性变更或数据重置。正式可用(GA)版本将在之后发布。欢迎通过 GitHub 讨论区或 #registry-dev Discord提供反馈(此处提供加入说明)。

当前主要维护者:

贡献

我们通过多个渠道开展协作——请参阅 modelcontextprotocol.io/community/communication。

想法通常(但并非总是)会沿着以下流程推进:

快速入门:
前置条件
  • Docker
  • Go 1.24.x
  • ko - Go 容器镜像构建工具(安装说明)
  • golangci-lint v2.4.0
运行服务
# Start full development environment
make dev-compose

此命令会启动注册表,并通过 PostgreSQL 在 localhost:8080 提供服务。数据库使用临时存储,每次重启容器时都会重置,确保开发和测试环境保持干净。

注意: 注册表使用 ko 构建容器镜像。make dev-compose 命令会自动使用 ko 构建注册表镜像,并在启动服务前将其加载到本地 Docker 守护进程中。

默认情况下,注册表会从生产 API 获取经过筛选的服务器子集进行初始化(以加快启动速度)。这样可以确保本地环境与生产环境的行为一致,并且所有初始化数据都能通过验证。进行离线开发时,可以使用文件进行初始化且不进行验证:MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose。

可以通过 docker-compose.yml 中的环境变量配置此环境,参考 .env.example。

替代方案:运行预构建的 Docker 镜像

预构建的 Docker 镜像会自动发布到 GitHub Container Registry:

# Run latest stable release
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# Run latest from main branch (continuous deployment)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# Run specific release version
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# Run development build from main branch
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

可用标签:

  • 发布版本:latest、v1.0.0、v1.1.0 等
  • 持续构建:main(最新的 main 分支构建)
  • 开发版本:main-<date>-<sha>(特定提交的构建)
发布服务器

我们构建了一个简单的 CLI 来发布服务器。你可以这样使用:

# Build the latest CLI
make publisher

# Use it!
./bin/mcp-publisher --help

更多详情请参阅发布者指南。

其他命令
# Run lint, unit tests and integration tests
make check

此外,还有一些便于开发的命令。运行 make help 了解更多信息,或查看 Makefile。

架构

项目结构
├── cmd/                     # Application entry points
│   └── publisher/           # Server publishing tool
├── data/                    # Seed data
├── deploy/                  # Deployment configuration (Pulumi)
├── docs/                    # Documentation
├── internal/                # Private application code
│   ├── api/                 # HTTP handlers and routing
│   ├── auth/                # Authentication (GitHub OAuth, JWT, namespace blocking)
│   ├── config/              # Configuration management
│   ├── database/            # Data persistence (PostgreSQL)
│   ├── service/             # Business logic
│   ├── telemetry/           # Metrics and monitoring
│   └── validators/          # Input validation
├── pkg/                     # Public packages
│   ├── api/                 # API types and structures
│   │   └── v0/              # Version 0 API types
│   └── model/               # Data models for server.json
├── scripts/                 # Development and testing scripts
├── tests/                   # Integration tests
└── tools/                   # CLI tools and utilities
    └── validate-*.sh        # Schema validation tools
身份验证

发布支持多种身份验证方式:

  • GitHub OAuth - 登录 GitHub 后进行发布
  • GitHub OIDC - 从 GitHub Actions 进行发布
  • DNS 验证 - 证明对某个域名及其子域名的所有权
  • HTTP 验证 - 证明对某个域名的所有权

发布时,注册表会验证命名空间所有权。例如,要发布……:

  • io.github.domdomegg/my-cool-mcp,你必须以 domdomegg 身份登录 GitHub,或在 domdomegg 的仓库中运行 GitHub Action
  • me.adamjones/my-cool-mcp,你必须通过 DNS 或 HTTP 验证证明对 adamjones.me 的所有权

社区项目

查看社区项目,了解社区创建的知名注册表相关项目。

更多文档

如果这里没有解答你的问题,请参阅文档了解更多详情!

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。