MCP Server Altibase

🚀 Altibase MCP 服務器

Altibase MCP 服務器是一個基於 Altibase 實現的模型上下文協議（MCP）服務器，它提供數據庫交互和商業智能功能。藉助該服務器，用戶可以運行 SQL 查詢、分析商業數據，並自動生成業務見解備忘錄。此服務器的源代碼託管在 GitHub 上，同時也作為 Python 包上傳到了 PyPI。

🚀 快速開始

要使用此 MCP 服務器，您需要滿足以下先決條件：

1. Python 3.6 或更高版本
2. Altibase 數據庫安裝：請參閱 Altibase 文檔進行安裝和配置。
3. ODBC 驅動程序：確保系統上安裝了與 Altibase 兼容的 ODBC 驅動程序。

Unixodbc 設置示例（Linux）

安裝 unixodbc

在基於 Debian 的系統上：

sudo apt-get install unixodbc-dev

在基於 Red Hat 的系統上：

sudo yum install unixODBC-devel

配置 odbc.ini

創建或編輯 /etc/odbc.ini 文件，添加以下內容：

[Altibase_DSN]
Description = Altibase ODBC Driver
Driver      = /usr/lib/x86_64-linux-gnu/odbc/altibase.so
Database    = your_database_name
User        = your_username
Password    = your_password

Odbc 配置示例（Windows）

安裝 ODBC 驅動程序

1. 下載並安裝 Altibase 的 ODBC 驅動程序。
2. 將驅動程序添加到系統路徑中。

創建 DSN

1. 打開“控制面板” > “系統和安全” > “管理工具” > “數據源（ODBC）”。
2. 點擊“添加”按鈕，選擇 Altibase ODBC 驅動程序。
3. 填寫 DSN 名稱和其他必要的信息。

與 Claude Desktop 的使用

使用 uv

1. 安裝並運行 Claude Desktop。
2. 在終端中輸入以下命令：

   uv --directory /path/to/repo clone hess/mcp-server-altibase
   

3. 然後運行：

   uv --directory /path/to/repo run mcp-server-altibase --odbc-dsn "your_dsn_name"
   

使用 uvx

在終端中輸入以下命令：

uvx hess/mcp-server-altibase run -- odbc-dsn="your_dsn_name"

✨ 主要特性

• 提供數據庫交互和商業智能功能，允許運行 SQL 查詢、分析商業數據並自動生成業務見解備忘錄。
• 公開動態資源 memo://insights，可自動更新商業見解備忘錄。
• 提供演示提示 mcp-demo，引導用戶完成數據庫操作。
• 提供六個核心工具，涵蓋查詢、架構和突變等功能。

📚 詳細文檔

組件

資源

該服務器公開一個動態資源：

• memo://insights：一個不斷更新的商業見解備忘錄，聚合在分析過程中發現的所有見解。使用附言工具添加新見解時自動更新。

提示

該服務器提供了一個演示提示：

• mcp-demo：引導用戶完成數據庫操作的交互式提示。
  • 必要參數：topic（字符串）- 要分析的商業領域。
  • 自動生成適當的數據庫架構和樣例數據。
  • 引導用戶完成分析和見解生成。
  • 集成到商業見解備忘錄中。

工具

該服務器提供六個核心工具：

查詢工具

• read_query

  • 執行 SELECT 查詢以從數據庫讀取數據。
  • 輸入：
    • query（字符串）：要執行的 SELECT SQL 查詢。
  • 返回：查詢結果作為對象數組。

• write_query

  • 執行 INSERT、UPDATE 或 DELETE 查詢。
  • 輸入：
    • query（字符串）：SQL 修改查詢。
  • 返回：{ affected_rows: number }。

• create_table

  • 在數據庫中創建新表。
  • 輸入：
    • query（字符串）：CREATE TABLE SQL 語句。
  • 返回：確認表格已創建。

架構工具

• list_tables

  • 獲取數據庫中所有表的列表。
  • 無需輸入。
  • 返回：表名稱數組。

• describe_table

  • 查看特定表的架構信息。
  • 輸入：
    • table_name（字符串）：要描述的表的名稱。
  • 返回：表的列及其數據類型的詳細信息。

突變工具

• execute_trigger
  • 執行數據庫中的觸發器。
  • 輸入：
    • trigger_name（字符串）：要執行的觸發器的名稱。
  • 返回：操作結果的狀態。

其他信息

• 此源代碼託管在 https://github.com/hesslee/mcp-server-altibase
• 此源代碼基於 https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite
• 此包上傳到 https://pypi.org/project/mcp-server-altibase