MCP Db Context

🚀 MCP 服務器

MCP 服務器專為大規模 Oracle 數據庫量身打造，提供了豐富的數據庫上下文功能。它能幫助用戶高效地搜索表列、獲取 PL/SQL 對象信息、查看錶約束和索引等，極大提升了數據庫管理和操作的便利性。

🚀 快速開始

本部分暫未提供快速開始的相關內容，若你需要了解如何快速啟動 MCP 服務器，可以參考後續的安裝指南和使用說明。

✨ 主要特性

MCP（Database Context Provider）服務器具備一系列強大的工具，主要功能如下：

• search_columns：可搜索包含特定術語的表列。
• get_pl_sql_objects：能獲取與指定模式匹配的所有 PL/SQL 對象信息。
• get_object_source：用於顯示特定 PL/SQL 對象的源代碼。
• get_table_constraints：展示表上的所有約束，包括主鍵、外鍵、唯一約束、檢查約束。
• get_table_indexes：列出表上定義的所有索引，有助於查詢優化。
• get_dependent_objects：查找依賴於指定數據庫對象的所有對象。
• get_user_defined_types：顯示數據庫中自定義類型的信息。
• get_related_tables：展示與指定表通過外鍵關係相關的所有表。

🔧 技術細節

架構

MCP 服務器採用三層架構，有效優化了大規模 Oracle 數據庫的性能：

1. DatabaseConnector 層
   • 負責管理 Oracle 數據庫的連接和查詢執行。
   • 實現了連接池和重試邏輯，確保連接的穩定性。
   • 直接處理原始 SQL 操作。
2. SchemaManager 層
   • 實現了智能模式緩存，提高了數據檢索效率。
   • 提供高效的模式查找和搜索功能。
   • 管理持久化在磁盤上的緩存。
3. DatabaseContext 層
   • 提供高級 MCP 工具和接口，方便用戶操作。
   • 處理授權和訪問控制，保障數據安全。
   • 優化模式信息，便於 AI 使用。

連接模式

數據庫連接器支持兩種工作模式：

Thin Mode（默認）

默認情況下，連接器使用 Oracle 的薄模式，這是一種純 Python 實現。其優點包括：

• 部署和設置更加容易。
• 足以處理大多數基本數據庫操作。
• 具有更高的環境可移植性。

Thick Mode

對於需要高級 Oracle 功能或更好性能的場景，可以啟用厚模式：

• 使用 Docker：在 Docker 環境變量中設置 THICK_MODE=1。
• 本地安裝：導出 THICK_MODE=1 環境變量，並確保已安裝與系統架構和數據庫版本兼容的 Oracle 客戶端庫。

注意：使用 Docker 時，無需擔心安裝 Oracle 客戶端庫，因為它們已包含在容器中（Oracle Instant Client v23.7）。容器支持 Oracle 數據庫版本從 19c 到 23ai，適用於 Linux/arm64 和 Linux/amd64 架構。

📦 安裝指南

系統要求

• Python：版本 3.12 或更高（建議使用以獲得最佳性能）。
• 內存：至少 4GB 可用 RAM（適用於擁有 10,000 張表以上的大型數據庫）。
• 磁盤空間：最少 500MB 的空閒空間用於模式緩存。
• Oracle 數據庫：兼容 Oracle Database 11g 及更高版本。
• 網絡：與 Oracle 數據庫服務器的穩定連接。

📈 性能考量

• 初始緩存構建時間可能需要 5 - 10 分鐘（具體取決於數據庫大小）。
• 後續啟動時間大幅縮短，僅需幾秒即可完成。
• 支持高併發訪問，性能表現優異。

🤝 貢獻指南

歡迎社區貢獻！請參考項目文檔瞭解如何參與開發和提交問題。

📞 支持信息

如需獲取更多信息或技術支持，請聯繫 project maintainers。項目的許可協議詳見 LICENSE 文件。