Is Mcp Yashan safe to install?

SaferSkills independently audited Mcp Yashan (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md7.5 KB · Markdown

崖山数据库 MCP Server

一个用于连接崖山数据库（YashanDB）的 MCP（Model Context Protocol）Server，让 AI 助手能够自然语言查询崖山数据库。

🚀 快速开始

新用户推荐：5 分钟快速上手指南

一键健康检查

python3 scripts/health_check.py

自动检查 Java 环境、依赖、配置和数据库连接。

交互式配置

mcp-yashan --configure

或者

python3 -m mcp_yashan.mcp_server --configure

按照提示输入数据库信息，自动测试连接并保存配置。

📚 文档导航

文档	说明
快速开始	5 分钟快速配置和测试
使用示例	常见查询、AI 提示词、最佳实践
STDIO 模式	推荐的本地使用方式（详细配置）
HTTP 模式	远程访问、多用户共享
SQL 语法指南	崖山数据库 SQL 参考

使用模式

本项目支持两种使用模式：

🌟 STDIO 模式（推荐）

按需启动，用完即退，资源占用低

适合：本地开发、AI 工具集成（Kiro、Claude Desktop 等）

python3 mcp_server.py

详见 STDIO 模式文档

🌐 HTTP 模式

常驻服务，支持远程访问

适合：远程访问、多用户共享、高频查询

python3 server.py --host 0.0.0.0 --port 20302

详见 HTTP 模式文档

快速入口

STDIO 模式（推荐）：docs/STDIO_MODE.md
HTTP 模式：docs/HTTP_MODE.md
快速上手：docs/QUICK_START.md
SQL 参考：docs/YASHAN_SQL_GUIDE.md
Windows 开机启动：docs/WINDOWS_AUTOSTART.md

项目结构

mcp-yashan/
├── mcp_yashan/                 # 源代码（Python 包）
│   ├── __init__.py
│   ├── mcp_server.py          # STDIO 模式入口
│   ├── http_server.py         # HTTP 模式入口
│   ├── core/                  # 核心逻辑
│   │   ├── __init__.py
│   │   ├── executor.py        # SQL 执行器
│   │   ├── metadata.py        # 元数据管理
│   │   └── tools.py           # MCP 工具定义
│   └── runtime/               # 运行时依赖
│       ├── yashandb-jdbc-1.9.3.jar
│       └── java/
│           └── yashan-mcp-helper.jar
├── config/                     # 配置文件
│   └── .env.example           # 配置模板
├── scripts/                    # 脚本工具
│   ├── start.sh               # HTTP 模式启动脚本
│   ├── package_release.sh     # 打包脚本
│   └── create_autostart_task.ps1
├── tests/                      # 测试
│   ├── test_stability.py      # 稳定性测试
│   └── test_jdbc.py           # JDBC 连接测试
├── docs/                       # 文档
│   ├── STDIO_MODE.md          # STDIO 模式文档
│   ├── HTTP_MODE.md           # HTTP 模式文档
│   ├── QUICK_START.md         # 快速开始
│   └── YASHAN_SQL_GUIDE.md    # SQL 语法指南
├── pyproject.toml              # Python 包配置
├── MANIFEST.in                 # 打包清单
├── README.md                   # 项目说明
└── LICENSE                     # MIT 许可证

完整的数据库操作：支持查询、插入、更新、删除等 SQL 操作
MCP SSE / Streamable HTTP 协议支持
元数据管理：表结构、索引、表搜索、行数统计
支持多 Schema 场景
详细的错误处理和日志记录
Oracle 兼容语法支持
仓库内置 Java Runtime，普通使用场景下不依赖用户系统 Java

前置要求

Python 3.10+
Java 8+ (JDK 或 JRE)
崖山数据库或其他兼容数据库
JDBC 驱动：yashandb-jdbc-1.9.3.jar（已包含在 runtime/ 目录）

Java 安装

项目需要 Java 运行时环境（JRE 8+）来执行 SQL 查询。

检查 Java 版本：

java -version
# 需要显示 1.8 或更高版本

如果未安装 Java：

macOS: brew install openjdk@17
Ubuntu/Debian: sudo apt install openjdk-17-jre
CentOS/RHEL: sudo yum install java-17-openjdk
Windows: 从 Oracle 或 OpenJDK 下载安装

注意：项目会自动查找系统 Java，无需额外配置。

安装

python3 -m pip install -r requirements.txt

注意：确保已安装 Java 8+ (JRE 或 JDK)。检查：java -version

配置

推荐使用 .env：

cp config/.env.example .env

然后填写：

DB_HOST=your_database_host
DB_PORT=1688
DB_NAME=yashandb
DB_USER=your_username
DB_PASSWORD=your_password

# 可选：SQL 执行超时时间（秒），默认 60
# SQL_TIMEOUT=60

如果你的数据库连接参数较复杂，也可以直接配置完整 JDBC URL：

DB_JDBC_URL=jdbc:yasdb://host:port/dbname?param=value

运行

STDIO 模式（推荐）

python3 -m mcp_yashan.mcp_server

HTTP 模式

./scripts/start.sh
# 或
python3 -m mcp_yashan.http_server --host 0.0.0.0 --port 20302

注意：首次运行前请确保已安装 Java 并配置 .env 文件。

集成到 AI 工具

STDIO 模式（推荐）

在 Kiro 或 Claude Desktop 的 MCP 配置中添加：

{
  "mcpServers": {
    "yashan": {
      "command": "python3",
      "args": ["-m", "mcp_yashan.mcp_server"]
    }
  }
}

或者使用绝对路径（开发环境）：

{
  "mcpServers": {
    "yashan": {
      "command": "python3",
      "args": ["<项目绝对路径>/mcp_yashan/mcp_server.py"]
    }
  }
}

获取项目绝对路径：在项目目录下执行 pwd

HTTP 模式

如果客户端支持 streamable-http：

{
  "mcpServers": {
    "yashan": {
      "type": "streamable-http",
      "url": "http://你的服务IP:20302/mcp"
    }
  }
}

详见对应模式的文档。

MCP 工具能力

工具名	描述
`test_connection`	测试数据库连接
`run_sql`	执行 SQL 查询
`list_schemas`	列出所有 Schema
`list_tables`	列出表
`describe_table`	查看表结构
`search_tables`	搜索表
`get_table_indexes`	查看表索引
`get_table_count`	获取表行数
`get_database_info`	获取数据库信息
`explain_sql`	获取 SQL 执行计划

发布

可使用：

./scripts/package_release.sh

打包后会在 release/ 目录下生成可分发压缩包。

目录说明

server.py：服务入口
core/：SQL 执行和元数据逻辑
runtime/jre/：随包分发的 Java Runtime
runtime/java/yashan-mcp-helper.jar：预编译 Java helper
logs/：按天滚动日志
docs/：补充文档

许可证

MIT License

第三方依赖许可证

本项目包含以下第三方依赖：

yashandb-jdbc-1.9.3.jar - Apache License 2.0
崖山数据库 JDBC 驱动
许可证：http://www.apache.org/licenses/LICENSE-2.0

yashan-mcp-helper.jar - MIT License
本项目编译的 Java 辅助类

Mcp Yashan— agent skill

Is Mcp Yashan safe to install?

崖山数据库 MCP Server

🚀 快速开始

一键健康检查

交互式配置

📚 文档导航

使用模式

🌟 STDIO 模式（推荐）

🌐 HTTP 模式

快速入口

项目结构

前置要求

Java 安装

安装

配置

运行

STDIO 模式（推荐）

HTTP 模式

集成到 AI 工具

STDIO 模式（推荐）

HTTP 模式

MCP 工具能力

发布

目录说明

许可证

第三方依赖许可证

Audit the pieces. Scan the whole. Decide.