{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fswmqv6buzm5","handle":"xugu-mcp","url":"https://wellknown.network/agents/xugu-mcp","links":{"self":"https://wellknown.network/agents/xugu-mcp/record.json","html":"https://wellknown.network/agents/xugu-mcp","markdown":"https://wellknown.network/agents/xugu-mcp/record.md","api":"https://wellknown.network/api/v1/agents/xugu-mcp","status":"https://wellknown.network/api/v1/agents/xugu-mcp/status","claim":"https://wellknown.network/agents/xugu-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/xugu-mcp/claim.json","badge":"https://wellknown.network/agents/xugu-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:xugu-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"xugu-mcp","summary":"XuguDB MCP Server with Chat2SQL support - A Model Context Protocol server for XuguDB (虚谷数据库) with full DDL/DML support, multi-LLM provider integration, and natural language to SQL conversion capabilities.","description":"# XuguDB MCP Server\n\n[![PyPI Version](https://img.shields.io/pypi/v/xugu-mcp)](https://pypi.org/project/xugu-mcp/)\n[![Python Version](https://img.shields.io/pypi/pyversions/xugu-mcp)](https://pypi.org/project/xugu-mcp/)\n[![License](https://img.shields.io/pypi/l/xugu-mcp)](LICENSE)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\nA Model Context Protocol (MCP) server for [XuguDB](https://docs.xugudb.com/content/development/python) (虚谷数据库) with full DDL/DML support, multi-LLM provider integration, and Chat2SQL (natural language to SQL) capabilities.\n\n## Features\n\n- **Full Database Operations**: Support for SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP\n- **Schema Introspection**: List tables, describe table structure, view relationships\n- **Chat2SQL**: Convert natural language queries to SQL using LLMs (Claude, OpenAI, local models)\n- **Multi-LLM Support**: Flexible LLM provider configuration (Claude, OpenAI, zAI/Zhipu, Local/Ollama)\n- **Connection Pooling**: Efficient database connection management\n- **Audit Logging**: Comprehensive operation logging for security\n- **Query Optimization**: EXPLAIN support and optimization suggestions\n\n## Installation\n\n### Prerequisites\n\n> **IMPORTANT Python Version Requirement:** This project requires **Python 3.6 through 3.11** (Python 3.12+ is NOT currently supported due to XuguDB driver compatibility).\n\n- **Python 3.6, 3.7, 3.8, 3.9, 3.10, or 3.11** (3.11 recommended)\n- XuguDB database instance\n- (Optional) LLM API key for Chat2SQL features\n\n**If your Python version is incorrect, use the automatic setup scripts below** - they will automatically install and configure the correct Python version for you!\n\n### Quick Setup (Recommended)\n\nThe project provides **automatic setup scripts** that will check and configure your environment:\n\n#### Windows\n\n```powershell\n# Run the setup script\n.\\scripts\\setup.ps1\n```\n\n#### macOS / Linux\n\n```bash\n# Make script executable (first…","publisher":null,"homepage":"https://github.com/LeoKuPo/xugu-mcp/blob/main/README.ch.md","repository":"https://github.com/LeoKuPo/xugu-mcp/blob/main/README.ch.md","version":"0.2.2","license":"MIT","protocols":["mcp"],"tags":["anthropic","chat2sql","claude","database","database-driver","llm","mcp","model-context-protocol","openai","sql","sql-tools","xugu","xugudb","虚谷数据库"],"pricing":null,"endpoints":[{"url":"pypi:xugu-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"documents.conversion","name":"Document Conversion","confidence":0.836,"provenance":"derived"}],"categories":["data","documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"xugu-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:22.675Z","publishedAt":"2026-01-14T03:50:36.624423Z","latestVersion":"0.2.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"xugu-mcp","url":"https://pypi.org/project/xugu-mcp/","firstSeenAt":"2026-09-10T16:23:04.436Z","fetchedAt":"2026-09-10T16:23:04.436Z","normalizedAt":"2026-09-10T16:23:04.436Z"}]},"firstSeenAt":"2026-09-10T16:23:04.436Z","updatedAt":"2026-09-10T16:24:22.675Z"}