XiYan MCP Server

@XGenerationLab

Repository

Basic information

About XiYan MCP Server

A Model Context Protocol (MCP) server that enables natural language queries to databases

#database #mcp#text-to-sql

XiYan MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xiyan-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "xiyan_mcp_server"
      ],
      "env": {
        "YML": "PATH/TO/YML"
      }
    }
  }
}

XiYan MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is XiYan MCP Server?

A Model Context Protocol (MCP) server that enables natural language queries to databases. It is powered by XiYan-SQL, the state-of-the-art text-to-SQL system on open benchmarks, and is intended for developers and data analysts who want to query databases using natural language through MCP-compatible clients (e.g., Claude Desktop, Cursor).

How to use XiYan MCP Server?

Install the server with pip install xiyan-mcp-server, then provide a YAML configuration file specifying the LLM model, API key, database credentials, and transport protocol (stdio or sse). Launch the server with YML=path/to/yml python -m xiyan_mcp_server and connect it to a supported MCP client.

Key features of XiYan MCP Server

Query databases using natural language via XiYanSQL
Supports general LLMs (GPT, Qwen-max) and a SOTA text-to-SQL model
Runs in pure local mode for high security
Works with MySQL and PostgreSQL databases
Lists available tables and reads table contents as resources

Use cases of XiYan MCP Server

Build a local data assistant that answers questions from a database
Enable non-technical users to explore data via chat interfaces
Integrate natural-language database access into MCP-compatible IDEs or tools

Frequently asked questions

What databases does XiYan MCP Server support?

MySQL and PostgreSQL are currently supported. More dialects are planned.

Do I need an API key to use the server?

It depends on the model. General LLMs require an API key from the provider (e.g., OpenAI, Alibaba Cloud). The SOTA model can be used via Modelscope (requires a free API-inference key) or via Dashscope (key provided by email for trial). Local mode requires no API key.

Can I run the server entirely offline?

Yes. You can deploy the XiYanSQL-QwenCoder model locally and set the configuration to point to your local endpoint, achieving a fully local and high-security setup.

What transport protocols are supported?

The server supports both `stdio` (default) and `sse` transport protocols, making it compatible with a variety of MCP clients.

How do I get a trial key for the Dashscope‑hosted SOTA model?

Send an email to godot.lzl@alibaba-inc.com with your name, email, and organization to request a key. The key expires after one month or 200 queries.

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w