介绍

本指南详细介绍了如何安装和配置mcp-odbc-server，并展示了如何在不同的工具中使用它，包括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数据交互。