How do I use io.github.willorn/mcp-yashan?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@io.github.willorn/mcp-yashan Show me all tables in the database" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

io.github.willorn/mcp-yashan

by willorn

Overview Schema Related Servers Score Discussions

Python

Hybrid

崖山数据库 MCP Server

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

Python License

🚀 快速开始

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

一键健康检查

python3 scripts/health_check.py

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

交互式配置

mcp-yashan --configure

或者

python3 -m mcp_yashan.mcp_server --configure

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

Related MCP server: GraphJin

📚 文档导航

文档	说明
快速开始	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 辅助类

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

5dRelease cycle

2Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/willorn/mcp-yashan'

If you have feedback or need assistance with the MCP directory API, please join our Discord server