# mcp-server

**Repository Path**: retire/mcp-server

## Basic Information

- **Project Name**: mcp-server
- **Description**: mcp-server
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Server 项目集合

本仓库包含三个基于 Model Context Protocol (MCP) 的数据库服务器实现，分别使用 Python 和 Go 语言开发，支持 MySQL 和 Oracle 数据库，为 AI 助手提供安全、高效的数据库访问能力。

## 项目概览

### 🐍 [mysql-mcp-server](./mysql-mcp-server/) - Python 版本

一个功能完整的 Python 实现的 MySQL MCP 服务器，提供丰富的数据库操作功能和灵活的配置选项。

**主要特性：**
- 🔌 完整实现 MCP 2024-11-05 协议规范
- 🗄️ 原生 MySQL 数据库集成
- 🏊 高效连接池管理，支持自动重连和健康检查
- 🔒 内置 SQL 注入防护和查询验证机制
- 📊 详细的查询统计和性能监控
- 🔧 支持环境变量和配置文件的灵活配置
- 📝 结构化日志记录和错误追踪
- 🧪 全面的单元测试和集成测试覆盖

**适用场景：**
- 快速原型开发和测试
- 需要丰富功能特性的应用场景
- Python 生态系统集成
- 教学和学习 MCP 协议

**快速开始：**
```bash
cd mysql-mcp-server
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 配置数据库连接
python -m src.mysql_mcp_server.main
```

---

### 🚀 [mysql-mcp-server-go](./mysql-mcp-server-go/) - Go 版本

一个高性能的 Go 语言实现的 MySQL MCP 服务器，专注于性能和并发处理能力。

**主要特性：**
- 🚀 Go 语言实现，提供卓越的并发性能
- 🔒 内置安全机制，包括 SQL 注入防护
- 📊 完整的数据库操作支持（查询、表结构、表列表等）
- 🐳 完整的容器化部署支持（Docker + Docker Compose）
- 🔧 开发友好的热重载环境
- 📝 结构化日志记录，便于调试和监控
- 🧪 包含单元测试和集成测试
- ⚡ 优化的内存使用和垃圾回收

**适用场景：**
- 生产环境部署
- 高并发访问需求
- 性能敏感的应用
- 微服务架构集成
- 容器化部署环境

**快速开始：**
```bash
cd mysql-mcp-server-go
# 使用 Docker Compose（推荐）
cp .env.example .env
docker-compose up -d

# 或本地开发
go mod download
make run
```

---

### 🔶 [oracle-mcp-server](./oracle-mcp-server/) - Oracle Go 版本

一个专为 Oracle 数据库优化的 Go 语言实现的 MCP 服务器，提供企业级数据库访问能力。

**主要特性：**
- 🚀 Go 语言实现，提供卓越的并发性能
- 🔶 原生 Oracle 数据库集成，支持 Oracle 特有功能
- 🔒 内置安全机制，包括 SQL 注入防护
- 📊 完整的数据库操作支持（查询、表结构、表列表等）
- 🐳 完整的容器化部署支持（Docker + Docker Compose）
- 🔧 开发友好的热重载环境
- 📝 结构化日志记录，便于调试和监控
- 🧪 包含单元测试和集成测试
- ⚡ 优化的内存使用和垃圾回收

**适用场景：**
- 企业级 Oracle 数据库环境
- 生产环境部署
- 高并发访问需求
- 性能敏感的应用
- 微服务架构集成
- 容器化部署环境

**快速开始：**
```bash
cd oracle-mcp-server
# 使用 Docker Compose（推荐）
cp .env.example .env
docker-compose up -d

# 或本地开发
go mod download
make run
```

## 技术对比

| 特性 | Python 版本 | MySQL Go 版本 | Oracle Go 版本 |
|------|-------------|---------------|----------------|
| **性能** | 中等 | 高 | 高 |
| **内存使用** | 较高 | 低 | 低 |
| **并发处理** | 受 GIL 限制 | 原生协程支持 | 原生协程支持 |
| **部署复杂度** | 简单 | 简单（容器化） | 简单（容器化） |
| **开发速度** | 快 | 中等 | 中等 |
| **生态系统** | 丰富 | 现代化 | 现代化 |
| **数据库支持** | MySQL | MySQL | Oracle |
| **适用场景** | 原型开发、功能丰富 | 生产环境、高性能 | 企业级、Oracle环境 |

## MCP 协议支持

三个版本都完整支持 MCP 协议的核心功能：

### 支持的工具
- `list-tables` - 列出数据库中的所有表
- `describe-table` - 获取表结构信息
- `execute-query` - 执行 SQL 查询（支持参数化查询）
- `get-server-info` - 获取服务器信息和统计

### 支持的资源
- `mysql://database-info` - 数据库基本信息（MySQL 版本）
- `mysql://tables` - 数据库表列表（MySQL 版本）
- `mysql://table/{table_name}` - 特定表的结构信息（MySQL 版本）
- `mysql://server-stats` - 服务器统计信息（MySQL 版本）
- `oracle://database-info` - 数据库基本信息（Oracle 版本）
- `oracle://tables` - 数据库表列表（Oracle 版本）
- `oracle://table/{table_name}` - 特定表的结构信息（Oracle 版本）
- `oracle://server-stats` - 服务器统计信息（Oracle 版本）

## IDE 集成

三个版本都支持主流 AI IDE 的集成：

- **Cursor IDE** - 通过 MCP 扩展直接集成
- **Claude Desktop** - 配置 MCP 服务器连接
- **其他支持 MCP 的 IDE** - 通过标准 MCP 协议连接

详细的 IDE 配置说明请参考各项目的 README 文件。

## 选择建议

### 选择 Python 版本，如果你：
- 正在进行快速原型开发
- 需要与 Python 生态系统集成
- 团队主要使用 Python 技术栈
- 优先考虑开发速度和功能丰富性
- 使用 MySQL 数据库

### 选择 MySQL Go 版本，如果你：
- 部署到生产环境
- 需要处理高并发访问
- 优先考虑性能和资源使用效率
- 使用容器化部署方案
- 使用 MySQL 数据库

### 选择 Oracle Go 版本，如果你：
- 使用 Oracle 数据库环境
- 需要企业级数据库功能
- 部署到生产环境
- 需要处理高并发访问
- 优先考虑性能和资源使用效率
- 使用容器化部署方案

## 贡献指南

欢迎为项目贡献代码！请查看各子项目的贡献指南：
- [Python 版本贡献指南](./mysql-mcp-server/CONTRIBUTING.md)
- [MySQL Go 版本贡献指南](./mysql-mcp-server-go/docs/DEVELOPMENT.md)
- [Oracle Go 版本贡献指南](./oracle-mcp-server/docs/DEVELOPMENT.md)

## 许可证

本项目采用 MIT 许可证。详情请参见各子项目的 LICENSE 文件。

## 支持

如果你遇到问题或有建议，请：
1. 查看相关项目的文档
2. 搜索已有的 Issues
3. 创建新的 Issue 描述问题
4. 参与社区讨论

---

**快速链接：**
- [Python 版本详细文档](./mysql-mcp-server/README.md)
- [MySQL Go 版本详细文档](./mysql-mcp-server-go/README.md)
- [Oracle Go 版本详细文档](./oracle-mcp-server/README.md)
- [MCP 协议规范](https://modelcontextprotocol.io/)