Openlinksoftware MCP Odbc Server

🚀 mcp - odbc - server項目

本項目的mcp-odbc-server能助力用戶輕鬆與ODBC數據源交互並執行各類查詢。本指南會詳細介紹其安裝、配置方法，以及如何在Claude Desktop、Cline Visual Studio Extension和Cursor Editor等工具中使用。

🚀 快速開始

本指南將詳細指引您完成mcp-odbc-server的安裝、配置，並展示如何在不同工具中使用它，從而實現與ODBC數據源的交互和查詢操作。

✨ 主要特性

• 支持在Claude Desktop、Cline Visual Studio Extension和Cursor Editor等多種工具中使用。
• 可以方便地與ODBC數據源進行交互，執行查詢和插入等操作。

📦 安裝指南

系統要求

• 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"
      }
    }
  }
}

使用指南

在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
   

💻 使用示例

基礎用法

查詢數據

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]);
}

🔧 技術細節

故障排除

• 問題：服務器啟動失敗。

• 解決方法：檢查Node.js版本和環境變量是否正確配置。

• 問題：無法連接到數據源。

• 解決方法：驗證ODBC DSN名稱和驅動程序是否正確安裝。

📄 許可證

文檔未提及相關信息，暫不展示。

參考資料

• Node.js官方文檔
• TypeScript官方文檔
• MCP項目文檔

通過以上步驟，您可以輕鬆配置和使用mcp-odbc-server，並在各種工具中進行高效的ODBC數據交互。