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数据交互。