semvec/pypi-packages huggingface dataset:
sp-database-mcp 0.1.2
A Model Context Protocol server for database schema information
License: MIT
Requires Python: >=3.10
Keywords: database, mcp, model-context-protocol, schema

# SP Database MCP Server

一个用于实时获取数据库表结构信息的 Model Context Protocol (MCP) 服务器。通过 MCP 协议，可以让 AI 助手实时获取数据库的表结构信息，解决信息不及时更新的问题。

## 功能特性

- **智能表结构查询**：支持两种查询模式
  - **低代码系统 Schema 查询**：通过 `da_logic_entity` 和 `da_entity_attribute` 表获取详细的业务字段信息
  - **传统数据库元数据查询**：直接从数据库系统表获取技术字段信息
- 🔄 实时获取数据库表结构信息
- 📊 支持多种数据库类型 (MySQL, PostgreSQL)
- 🚀 通过 API 接口动态获取最新的表字段信息
- 🔍 支持表信息查询和字段详情获取
- 📝 自动生成表结构文档

## 安装

```bash
cd ~/Project/sp-database-mcp
uv sync
```

## 配置

创建 `.env` 文件：

```env
# 数据库连接配置
DATABASE_URL=mysql://username:password@localhost:3306/database_name
# 或者 PostgreSQL
# DATABASE_URL=postgresql://username:password@localhost:5432/database_name

# API 接口配置（如果通过 API 获取）
API_BASE_URL=https://your-api-server.com
API_TOKEN=your-api-token
```

## 使用方式

### 启动 MCP 服务器

```bash
uv run sp-database-mcp
```

### 在 Claude Desktop 中配置

在 Claude Desktop 的配置文件中添加：

```json
{
  "mcpServers": {
    "sp-database": {
      "command": "uv",
      "args": ["run", "sp-database-mcp"],
      "cwd": "/Users/alexliu/Project/sp-database-mcp"
    }
  }
}
```

### 使用示例

- "介绍一下活动表有哪些字段"
- "获取 activity_node 表的结构信息"
- "查看用户表的字段定义"

## 使用示例

### 查询表结构信息

现在支持两种查询模式，系统会自动优先使用低代码系统的 schema 查询：

```python
# 通过 MCP 工具查询表信息
# 输入：请获取 activity_node 表的详细信息

# 输出示例（低代码系统 schema 查询结果）：
# activity_node 表结构信息
# 
# **表说明**: 活动
# 
# ## 字段信息
# 
# | 字段名 | 类型 | 可空 | 默认值 | 主键 | 说明 |
# |--------|------|------|--------|------|---------|
# | id | BIGINT | 否 | - | 是 | 主键ID |
# | name | VARCHAR(1000) | 是 | - | 否 | 活动名称 |
# | activity_code | VARCHAR(64) | 是 | - | 否 | 活动编码 |
# | business_object_id | BIGINT | 是 | - | 否 | 业务对象id |
# | ... | ... | ... | ... | ... | ... |
```

### 查询模式说明

1. **低代码系统 Schema 查询**（优先）
   - 查询 `da_logic_entity` 表获取实体基本信息
   - 查询 `da_entity_attribute` 表获取字段详细信息
   - 提供中文字段名、业务描述、数据类型等丰富信息
   - 支持外键关系解析

2. **传统数据库元数据查询**（回退）
   - 当低代码系统查询失败时自动回退
   - 直接从数据库系统表获取技术字段信息
   - 提供基础的字段类型、约束等信息

## 项目结构

```
sp-database-mcp/
├── src/
│   └── sp_database_mcp/
│       ├── __init__.py
│       ├── server.py          # MCP 服务器主文件
│       ├── database.py        # 数据库连接和查询
│       ├── api_client.py      # API 客户端
│       └── models.py          # 数据模型
├── tests/
├── .env.example
├── pyproject.toml
└── README.md
```

## 开发

```bash
# 安装开发依赖
uv sync --dev

# 运行测试
uv run pytest

# 代码格式化
uv run black .
uv run isort .

# 类型检查
uv run mypy .
```
epub-mcp-server 0.1.1
智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力
License: MIT
Requires Python: >=3.12
Keywords: mcp, epub360, template, search, ai, assistant

# 📋模板搜索 MCP 服务

> 智能模板发现助手 - 为 AI 应用提供强大的 epub360 模板搜索能力

## 🎯 产品定位

**智能模板发现助手** - 一个专为 AI 应用设计的 epub360 模板搜索服务，通过 Model Context Protocol (MCP) 标准为 Cursor、Claude 等 AI 工具提供强大的模板检索能力。

### 🌟 核心价值

- **🤖 AI 原生设计** - 专为 AI 工具优化的接口和响应格式
- **🔗 标准化集成** - 遵循 MCP 协议，可无缝集成到任何支持 MCP 的 AI 应用
- **🧠 智能搜索** - 支持中文关键词搜索，精准匹配模板需求
- **⚡ 高性能** - 快速响应，10秒超时保护



#### ✨ 功能特性

| 特性 | 说明 |

|------|------|

| 🔍 中文搜索 | 支持中文关键词智能搜索 |

| 📊 灵活限制 | 可配置返回数量（1-50个） |

| 🎨 详细信息 | 返回模板名称、描述、封面等 |

| ⚡ 快速响应 | 10秒超时保护，确保响应速度 |

| 🛡️ 错误处理 | 完善的异常处理和错误提示 |



### 📝 完善的日志系统

- 🛡️ 完善的异常处理机制
- 📝 详细的请求/响应日志
- 🔄 网络超时和重试保护
- 📊 实时状态监控

## 🎯 适用场景

### 1. 🤖 AI 辅助设计场景

```markdown
用户: "帮我找一些科技风格的模板"

AI: 通过 MCP 调用模板搜索，返回相关模板列表

```

**典型对话：**

- "我需要制作一个商务演示，有什么模板推荐？"
- "找一些适合教育培训的模板"
- "搜索几个现代简约风格的设计模板"

### 2. 📝 内容创作工作流

| 场景 | 描述 | 示例 |

|------|------|------|

| **博客写作** | 搜索适合的文章模板 | 技术博客、生活分享模板 |

| **演示制作** | 快速找到演示文稿模板 | 产品发布、项目汇报模板 |

| **营销材料** | 寻找宣传册、海报模板 | 品牌宣传、活动推广模板 |

### 3. 🛠️ 开发集成场景

- **Cursor IDE** - 在编程时快速查找UI模板
- **设计工具** - 集成到设计软件中
- **自动化工具** - 批量模板分析和管理
- **工作流集成** - 与现有设计流程无缝对接

### 4. 🎓 教育培训场景

- **课程设计** - 查找教育相关模板
- **培训材料** - 搜索培训演示模板
- **学术展示** - 寻找学术报告模板

## 📚 使用教程

### 🚀 第一步：启动服务器

```bash
# 1. 克隆项目，进入项目目录

git clone https://github.com/21epub/epub-mcp-server.git && cd epub-mcp-server

# 2. 确保Python环境

python --version  # 需要 Python 3.8+

# 3. 安装依赖

pip install mcp requests

# 4. 启动 MCP 服务器

python src/template_mcp_http_server.py

```



### ⚙️ 第二步：配置 Cursor

#### 方法一：编辑配置文件（推荐）

编辑 `~/.cursor/mcp.json`：

```json
{

  "mcpServers": {

    "epub_template_search": {

      "url": "http://localhost:8081/api/template",

      "transport": "sse"

    }

  }

}

```

#### 方法二：通过设置界面 

1. **打开 Cursor 设置**

   - macOS: `Cmd + Shift + J`
   - Windows/Linux: `Ctrl + Shift + J`

2. **添加 MCP 服务器**

   - 找到 "MCP Servers" 选项卡
   - 点击添加新服务器

3. **配置服务器信息**

   ```
   名称: epub_template_search
   
   URL: http://localhost:8081/api/template
   
   传输方式: SSE
   
   ```



### 🎮 第三步：在 Cursor 中使用

重启 Cursor 后，你可以通过以下方式使用：

#### 🔍 基础搜索示例

```markdown
# 简单搜索

请帮我搜索一些商务风格的模板

# 指定数量

找5个教育相关的模板给我

# 特定主题

我需要科技、未来感的设计模板

# 具体用途

帮我找适合产品发布会的演示模板

```

#### 🛠️ 直接工具调用

```markdown
# 直接调用工具

使用 search_templates 工具搜索 "医疗" 相关的模板，限制10个结果

# 批量分析

帮我分析一下 "商务"、"教育"、"科技" 这三个主题的模板特点

# 对比搜索

对比一下 "简约" 和 "复古" 风格的模板有什么区别

```

------

**🎨 让 AI 驱动的设计工作流更加高效！** ✨

> 这个 MCP 服务器为创意工作者提供了强大的模板搜索能力，让设计灵感触手可及！