{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_gjs4v9cm5pn4","handle":"sp-database-mcp","url":"https://wellknown.network/agents/sp-database-mcp","links":{"self":"https://wellknown.network/agents/sp-database-mcp/record.json","html":"https://wellknown.network/agents/sp-database-mcp","markdown":"https://wellknown.network/agents/sp-database-mcp/record.md","api":"https://wellknown.network/api/v1/agents/sp-database-mcp","status":"https://wellknown.network/api/v1/agents/sp-database-mcp/status","claim":"https://wellknown.network/agents/sp-database-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/sp-database-mcp/claim.json","badge":"https://wellknown.network/agents/sp-database-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:sp-database-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"sp-database-mcp","summary":"A Model Context Protocol server for database schema information","description":"# SP Database MCP Server\n\n一个用于实时获取数据库表结构信息的 Model Context Protocol (MCP) 服务器。通过 MCP 协议，可以让 AI 助手实时获取数据库的表结构信息，解决信息不及时更新的问题。\n\n## 功能特性\n\n- **智能表结构查询**：支持两种查询模式\n  - **低代码系统 Schema 查询**：通过 `da_logic_entity` 和 `da_entity_attribute` 表获取详细的业务字段信息\n  - **传统数据库元数据查询**：直接从数据库系统表获取技术字段信息\n- 🔄 实时获取数据库表结构信息\n- 📊 支持多种数据库类型 (MySQL, PostgreSQL)\n- 🚀 通过 API 接口动态获取最新的表字段信息\n- 🔍 支持表信息查询和字段详情获取\n- 📝 自动生成表结构文档\n\n## 安装\n\n```bash\ncd ~/Project/sp-database-mcp\nuv sync\n```\n\n## 配置\n\n创建 `.env` 文件：\n\n```env\n# 数据库连接配置\nDATABASE_URL=mysql://username:password@localhost:3306/database_name\n# 或者 PostgreSQL\n# DATABASE_URL=postgresql://username:password@localhost:5432/database_name\n\n# API 接口配置（如果通过 API 获取）\nAPI_BASE_URL=https://your-api-server.com\nAPI_TOKEN=your-api-token\n```\n\n## 使用方式\n\n### 启动 MCP 服务器\n\n```bash\nuv run sp-database-mcp\n```\n\n### 在 Claude Desktop 中配置\n\n在 Claude Desktop 的配置文件中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"sp-database\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"sp-database-mcp\"],\n      \"cwd\": \"/Users/alexliu/Project/sp-database-mcp\"\n    }\n  }\n}\n```\n\n### 使用示例\n\n- \"介绍一下活动表有哪些字段\"\n- \"获取 activity_node 表的结构信息\"\n- \"查看用户表的字段定义\"\n\n## 使用示例\n\n### 查询表结构信息\n\n现在支持两种查询模式，系统会自动优先使用低代码系统的 schema 查询：\n\n```python\n# 通过 MCP 工具查询表信息\n# 输入：请获取 activity_node 表的详细信息\n\n# 输出示例（低代码系统 schema 查询结果）：\n# activity_node 表结构信息\n# \n# **表说明**: 活动\n# \n# ## 字段信息\n# \n# | 字段名 | 类型 | 可空 | 默认值 | 主键 | 说明 |\n# |--------|------|------|--------|------|---------|\n# | id | BIGINT | 否 | - | 是 | 主键ID |\n# | name | VARCHAR(1000) | 是 | - | 否 | 活动名称 |\n# | activity_code | VARCHAR(64) | 是 | - | 否 | 活动编码 |\n# | business_object_id | BIGINT | 是 | - | 否 | 业务对象id |\n# | ... | ... | ... | ... | ... | ... |\n```\n\n### 查询模式说明\n\n1. **低代码系统 Schema 查询**（优先）\n   - 查询 `da_logic_entity` 表获取实体基本信息\n   - 查询 `da_entity_attribute` 表获取字段详细信息\n   - 提供中文字段名、业务描述、数据类型等丰富信息\n   - 支持外键关系解析\n\n2. **传统数据库元数据查询**（回退）\n   - 当低代码系统查询失败时自动回退\n   - 直接从数据库系统表获取技术字段信息\n   - 提供基础的字段类型、约束等信息\n\n## 项目结构\n\n```\nsp-database-mcp/\n├── src/\n│   └── sp_database_mcp/\n│       ├── __init__.py\n│       ├── server.py    …","publisher":null,"homepage":"https://github.com/alexliu/sp-database-mcp#readme","repository":"https://github.com/alexliu/sp-database-mcp#readme","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["database","mcp","model-context-protocol","schema"],"pricing":null,"endpoints":[{"url":"pypi:sp-database-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"}],"categories":["data"],"language":"fr"},"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":"sp-database-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:44.582Z","publishedAt":"2025-07-30T08:52:15.130292Z","latestVersion":"0.1.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"sp-database-mcp","url":"https://pypi.org/project/sp-database-mcp/","firstSeenAt":"2026-09-10T12:23:08.991Z","fetchedAt":"2026-09-10T12:23:08.991Z","normalizedAt":"2026-09-10T12:23:08.991Z"}]},"firstSeenAt":"2026-09-10T12:23:08.991Z","updatedAt":"2026-09-10T12:23:44.582Z"}