Altibase MCP Server

Altibase MCP サーバー

概要

• Altibase を通じてデータベースとのやり取りやビジネスインテリジェンス機能を提供する、Model Context Protocol（MCP）サーバーの実装です。
• このサーバーを使用すると、SQL クエリの実行、ビジネスデータの分析、ビジネスインサイトメモの自動生成ができます。
• このソースコードは https://github.com/hesslee/mcp-server-altibase で管理されています。
• このソースコードは https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite をベースにしています。
• このパッケージは https://pypi.org/project/mcp-server-altibase にアップロードされています。

コンポーネント

リソース

サーバーは、次の動的リソースを 1 つ公開します。

• memo://insights：分析中に発見されたインサイトを集約した、継続的に更新されるビジネスインサイトメモ
  • append-insight ツールを通じて新しいインサイトが発見されると、自動的に更新されます。

プロンプト

サーバーは、次のデモ用プロンプトを提供します。

• mcp-demo：データベース操作を案内する対話型プロンプト
  • 必須の引数：topic - 分析するビジネス領域
  • 適切なデータベーススキーマとサンプルデータを生成します。
  • 分析とインサイトの生成を案内します。
  • ビジネスインサイトメモと連携します。

ツール

サーバーは、次の 6 つの主要なツールを提供します。

クエリツール

• read_query

  • データベースからデータを読み取る SELECT クエリを実行します。
  • 入力：
    • query（string）：実行する SELECT SQL クエリ
  • 戻り値：オブジェクトの配列としてのクエリ結果

• write_query

  • INSERT、UPDATE、または DELETE クエリを実行します。
  • 入力：
    • query（string）：SQL 変更クエリ
  • 戻り値：{ affected_rows: number }

• create_table

  • データベースに新しいテーブルを作成します。
  • 入力：
    • query（string）：CREATE TABLE SQL ステートメント
  • 戻り値：テーブル作成の確認

スキーマツール

• list_tables

  • データベース内のすべてのテーブルの一覧を取得します。
  • 入力不要
  • 戻り値：テーブル名の配列

• describe_table

  • 指定したテーブルのスキーマ情報を表示します。
  • 入力：
    • table_name（string）：詳細を表示するテーブルの名前
  • 戻り値：名前と型を含む列定義の配列

分析ツール

• append_insight
  • メモリソースに新しいビジネスインサイトを追加します。
  • 入力：
    • insight（string）：データ分析で発見されたビジネスインサイト
  • 戻り値：インサイト追加の確認
  • memo://insights リソースの更新をトリガーします。

前提条件

• http://support.altibase.com/en/product から Altibase サーバーとクライアントをダウンロードしてインストールします。
• Linux 用 Unixodbc の設定
• Windows 用 ODBC DSN の設定

Linux 用 Unixodbc の設定例

• インストール：sudo apt-get install unixodbc-dev
• 設定例：

$ cat /etc/odbc.ini 
[PYODBC]
Driver          = /home/hess/work/altidev4/altibase_home/lib/libaltibase_odbc-64bit-ul64.so
Database        = mydb
ServerType      = Altibase
Server          = 127.0.0.1
Port            = 21121
UserName        = SYS
Password        = MANAGER
FetchBuffersize = 64
ReadOnly        = no

$ cat /etc/odbcinst.ini 
[ODBC]
Trace=Yes
TraceFile=/tmp/odbc_trace.log

Windows 用 ODBC DSN の設定例

• Altibase Windows ODBC ドライバーは、Altibase Windows クライアントのインストール時に登録されます。
• Altibase 用の ODBC DSN を追加します。
• 設定例：

[Altibase Connection Config]
Windows DSN Name: PYODBC
host(name or IP): 192.168.1.210
Port(default 20300): 21121
User: SYS
Password: MANAGER
Database: mydb
NLS_USE: UTF-8

Claude Desktop での使用方法

• Claude for desktop をインストールします。

uv

• uv をインストールします。
• uv は、Python パッケージ管理と仮想環境の作成において、pip および venv に代わる高速で効率的なツールとして設計されています。

git clone を使用しない MCP クライアント設定例

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "altibase": {
    "command": "uvx",
    "args": [
      "mcp-server-altibase@latest",
      "--odbc-dsn",
      "PYODBC"
    ]
  }
}

git clone を使用する MCP クライアント設定例

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "altibase": {
    "command": "uv",
    "args": [
      "--directory",
      "path/to/repository/directory",
      "run",
      "mcp-server-altibase",
      "--odbc-dsn",
      "PYODBC"
    ]
  }
}

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。これは、MIT License の利用規約に従うことを条件として、ソフトウェアを自由に使用、変更、配布できることを意味します。詳しくは、プロジェクトリポジトリの LICENSE ファイルをご覧ください。