# oraclemcp

**Repository Path**: educloudtest/oraclemcp

## Basic Information

- **Project Name**: oraclemcp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-24
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Oracle 19c MCP 运维工具集

为 Oracle 19c（含 RAC）提供巡检与诊断的 MCP 工具服务，可直接接入 **Dify 1.10+** 构建运维智能体。**支持同时管理多套独立 RAC 环境**（主库 / 分库 / 备库）。

## 工具能力

| 类别 | 工具 |
|---|---|
| 多库发现 | `list_databases`（列出所有可用库及连接状态） |
| 集群 | `check_instance_status` / `check_rac_cluster_health` / `check_service_status` |
| 存储 | `check_asm_diskgroups` / `check_tablespace_usage` / `check_archive_status` |
| 性能 | `check_database_performance` / `check_sql_performance` |
| 网络 | `check_network_status` |
| 安全 | `check_security_config` |
| 综合 | `run_health_check`（一键巡检） |

所有工具都接受 `db_target` 参数指定目标库，不传时使用默认库。

## 快速开始

```bash
cp .env.example .env
# 编辑 .env 配置 DB_TARGETS（多库）或 ORACLE_USER（单库）等
docker-compose up -d --build
docker-compose logs -f
```

启动后 MCP 端点：`http://<本机IP>:8080/mcp`（Streamable HTTP transport）

## 接入 Dify

详见 [`dify-setup-guide.md`](./dify-setup-guide.md)。

简版：
1. Dify → 工具 → MCP → 添加 MCP 服务
2. URL 填 `http://<本机IP>:8080/mcp`，传输方式选 `Streamable HTTP`
3. 创建 Agent 应用，勾选这 12 个工具，写好系统提示词即可对话使用
4. 多库使用时，告诉 LLM 各库的别名和用途，调用工具时传 `db_target` 参数

## 文档目录

| 文档 | 用途 |
|---|---|
| [`docs/design-doc.md`](./docs/design-doc.md) | 设计开发文档（技术选型、架构、模块职责、扩展指南） |
| [`docs/deployment-guide.md`](./docs/deployment-guide.md) | 部署文档（环境要求、Docker 部署、配置详解、故障排除） |
| [`dify-setup-guide.md`](./dify-setup-guide.md) | Dify 1.10 集成完整指南（含 Agent 构建步骤） |

## 技术栈

- Python 3.9 + `mcp>=1.9.0`（FastMCP）
- `oracledb` >= 1.4 (原 cx_Oracle) + Oracle Instant Client 19.31
- 容器基础镜像：Oracle Linux 8-slim

## 安全建议

- 创建专用只读账户（`SELECT_CATALOG_ROLE` + `SELECT ANY DICTIONARY`），不要用 `SYSTEM` 直连
- 同内网部署可关闭 API_KEY；跨网部署务必启用 `ENABLE_AUTH` 并配置 `ALLOWED_IPS`
- 容器内不应保存 Oracle 主用户的凭证文件