# mcp

**Repository Path**: minyang2018/mcp

## Basic Information

- **Project Name**: mcp
- **Description**: 自用 mcp工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP 服务器集合

本项目包含三个 Model Context Protocol (MCP) 服务器，用于增强 AI 助手的能力。

## 项目结构

```
mcp/
├── mysql-mcp/              # MySQL MCP 服务器
│   ├── mysql_mcp_server.py
│   ├── mysql_tools.py
│   ├── config.py
│   ├── requirements.txt
│   └── README.md
│
├── knowledge-graph-mcp/    # 知识图谱 MCP 服务器
│   ├── knowledge_graph_mcp_server.py
│   ├── knowledge_graph_tools.py
│   ├── config.py
│   ├── requirements.txt
│   ├── visualization/      # 可视化前端
│   └── README.md
│
├── file-mcp/               # 文件操作 MCP HTTP 服务器
│   ├── file_mcp_server.py
│   ├── file_tools.py
│   ├── config.py
│   ├── requirements.txt
│   ├── config.json.example
│   └── README.md
│
└── README.md              # 本文件
```

## 包含的 MCP 服务器

### 1. MySQL MCP 服务器

提供完整的 MySQL 数据库操作功能，包括：

- 数据库和表管理
- SQL 查询和执行
- 表结构修改
- 数据库比对和同步
- 数据迁移

**详细文档**：请查看 [mysql-mcp/README.md](mysql-mcp/README.md)

### 2. 知识图谱 MCP 服务器

提供知识图谱管理功能，用于需求分析、数据库设计和数据字典管理：

- 节点和关系管理
- 查询和检索
- 数据字典管理
- 可视化导出（Mermaid、Graphviz）
- 数据持久化和备份

**详细文档**：请查看 [knowledge-graph-mcp/README.md](knowledge-graph-mcp/README.md)

### 3. 文件操作 MCP HTTP 服务器

提供 markdown 文件操作功能，通过 HTTP 方式提供服务，支持 Dify 等平台调用：

- markdown 文件读取
- markdown 文件写入/创建
- markdown 文件删除
- 列出目录下的 markdown 文件
- 安全路径验证和文件类型限制

**详细文档**：请查看 [file-mcp/README.md](file-mcp/README.md)

## 快速开始

### 安装依赖

每个 MCP 服务器都有独立的依赖，请分别安装：

```bash
# 安装 MySQL MCP 依赖
cd mysql-mcp
pip install -r requirements.txt

# 安装知识图谱 MCP 依赖
cd ../knowledge-graph-mcp
pip install -r requirements.txt

# 安装文件操作 MCP 依赖
cd ../file-mcp
pip install -r requirements.txt
```

### 配置

每个 MCP 服务器都有独立的配置文件，请参考各自的 README.md 进行配置：

- MySQL MCP：支持环境变量和配置文件两种方式
- 知识图谱 MCP：支持环境变量和配置文件两种方式
- 文件操作 MCP：支持环境变量和配置文件两种方式，通过 HTTP 提供服务

### 在 Cursor 中使用

1. 在 Cursor 的 MCP 配置文件中添加服务器的配置
2. 配置相应的环境变量或配置文件
3. 重启 Cursor 即可使用

**MySQL MCP 配置示例**：参考 `mysql-mcp/cursor-mcp-config.json.example`  
**知识图谱 MCP 配置示例**：参考 `knowledge-graph-mcp/cursor-mcp-config.json.example`

### 在 Dify 中使用（文件操作 MCP）

1. 启动文件操作 MCP HTTP 服务器
2. 在 Dify 的 **Tools → MCP** 中添加 HTTP 服务器
3. 配置服务器 URL 和名称即可使用

**详细步骤**：参考 [file-mcp/README.md](file-mcp/README.md)

## 功能概览

### MySQL MCP 主要功能

- ✅ 列出数据库和表
- ✅ 查询表结构
- ✅ 执行 SQL 查询
- ✅ 修改表结构
- ✅ 数据库比对
- ✅ 结构同步
- ✅ 数据迁移

### 知识图谱 MCP 主要功能

- ✅ 节点管理（需求、功能、表、字段、bug）
- ✅ 关系管理（包含、依赖、映射）
- ✅ 路径查找和子图查询
- ✅ 数据字典管理
- ✅ 可视化导出（Mermaid、Graphviz）
- ✅ 数据备份和恢复

### 文件操作 MCP 主要功能

- ✅ 读取 markdown 文件
- ✅ 写入/创建 markdown 文件
- ✅ 删除 markdown 文件
- ✅ 列出目录下的 markdown 文件
- ✅ HTTP 接口支持 Dify 集成
- ✅ 安全路径验证和文件类型限制

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！