Openlinksoftware MCP Odbc Server

🚀 mcp-odbc-server

このガイドでは、mcp-odbc-serverのインストールと設定方法を詳細に説明し、Claude Desktop、Cline Visual Studio Extension、Cursor Editorなどのさまざまなツールでの使用方法を紹介します。これらの手順に従うことで、ユーザーはODBCデータソースと簡単にやり取りし、さまざまなクエリを実行できます。

🚀 クイックスタート

このガイドを通じて、mcp-odbc-serverのインストール、設定、そしてClaude Desktop、Cline Visual Studio Extension、Cursor Editorなどのツールでの使用方法を学ぶことができます。

📦 インストール

システム要件

• Node.jsバージョン：v21.1.0以上
• npm（Nodeパッケージマネージャー）

インストール手順

1. リポジトリをクローンする：

   git clone https://github.com/your-repository/mcp-odbc-server.git
   cd mcp-odbc-server
   

2. 依存関係をインストールする：

   npm install
   

3. サーバーを起動する：

   tsx src/main.ts
   

📚 ドキュメント

環境変数の設定

src/server.tsファイルを編集し、以下の環境変数を追加します。

import { environment } from './environment';

export const config = {
  ODBC_DSN: process.env.ODBC_DSN || 'YourDSN',
  NODE_VERSION: process.env.NODE_VERSION,
  PATH: process.env.PATH,
};

起動スクリプト

package.jsonに起動スクリプトを作成します。

{
  "scripts": {
    "start": "set NODE_VERSION=v21.1.0 && set PATH=~/.nvm/versions/node/v21.1.0/bin:${PATH} && tsx src/main.ts"
  }
}

ツールの設定

Claude Desktopの設定

~/.config/claude/settings.jsonファイルを編集し、以下の内容を追加します。

{
  "mcpServers": {
    "ODBC": {
      "command": "/path/to/node",
      "args": ["tsx", "src/main.ts"],
      "env": {
        "ODBC_DSN": "YourDSN"
      }
    }
  }
}

Cline Visual Studio Extensionの設定

~/.config/vscode/settings.jsonファイルを編集し、以下の内容を追加します。

{
  "extensions.claude-dev.settings.mcpServers.ODBC": {
    "command": "/path/to/node",
    "args": ["tsx", "src/main.ts"],
    "env": {
      "ODBC_DSN": "YourDSN"
    }
  }
}

Cursor Editorの設定

~/.config/cursor/settings.jsonファイルを編集し、以下の内容を追加します。

{
  "mcpServers": {
    "ODBC": {
      "command": "/path/to/node",
      "args": ["tsx", "src/main.ts"],
      "env": {
        "ODBC_DSN": "YourDSN"
      }
    }
  }
}

💻 使用例

基本的な使用法

データのクエリ

import { query } from './db';

export async function getData() {
  const result = await query('SELECT * FROM YourTable');
  return result;
}

データの挿入

import { execute } from './db';

export async function insertData(data: any) {
  const query = 'INSERT INTO YourTable VALUES (?)';
  await execute(query, [data]);
}

高度な使用法

これらのコードを使用することで、ODBCデータソースとのやり取りを行うことができます。

各ツールでの使用方法

Claude Desktopでの使用

1. Claude Desktopを起動します。
2. ターミナルを開き、以下のコマンドを実行します。

   npm start
   

Cline Visual Studio Extensionでの使用

1. Visual Studio Codeを開きます。
2. Cline拡張機能をインストールします。
3. 設定が完了したら、ターミナルで以下のコマンドを実行します。

   npm start
   

Cursor Editorでの使用

1. Cursor Editorを起動します。
2. ターミナルを開き、以下のコマンドを実行します。

   npm start
   

🔧 技術詳細

トラブルシューティング

• 問題：サーバーが起動しません。

• 解決策：Node.jsのバージョンと環境変数が正しく設定されていることを確認してください。

• 問題：データソースに接続できません。

• 解決策：ODBC DSN名とドライバーが正しくインストールされていることを確認してください。

参考資料

• Node.js公式ドキュメント
• TypeScript公式ドキュメント
• MCPプロジェクトドキュメント

以上の手順に従うことで、mcp-odbc-serverを簡単に設定し、さまざまなツールでODBCデータのやり取りを効率的に行うことができます。