MCP Server Altibase

🚀 Altibase MCP サーバー

Altibaseを通じて実現される、データベースの相互作用とビジネスインテリジェンス機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、SQLクエリを実行し、ビジネスデータを分析し、自動的にビジネスインサイトのメモを生成することができます。

🚀 クイックスタート

このAltibase MCPサーバーは、データベース操作やビジネスデータ分析を容易に行うことができます。以下に、その概要と使用方法を説明します。

✨ 主な機能

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

🔧 コンポーネント

📚 リソース

このサーバーは、動的なリソースを公開しています。

• memo://insights：分析過程で見つかったすべてのインサイトを集約した、不断に更新されるビジネスインサイトのメモです。付言ツールを使用して新しいインサイトを追加すると自動的に更新されます。

💡 プロンプト

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

• mcp-demo：ユーザーがデータベース操作を行うのをサポートする対話型のプロンプトです。
  • 必要なパラメータ：topic（文字列）- 分析するビジネス分野
  • 適切なデータベーススキーマとサンプルデータを自動生成します。
  • 分析とインサイト生成のプロセスをガイドします。
  • ビジネスインサイトのメモに統合されます。

🛠️ ツール

このサーバーは、6つの核心的なツールを提供しています。

クエリツール

• 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（文字列）：実行するトリガーの名前
  • 戻り値：操作結果のステータス

📦 インストール

前提条件

この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"