🚀 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包管理器）
安装步骤
- 克隆仓库：
git clone https://github.com/your-repository/mcp-odbc-server.git cd mcp-odbc-server - 安装依赖项：
npm install - 启动服务器：
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中使用
- 启动Claude Desktop。
- 打开终端，运行以下命令：
npm start
在Cline Visual Studio Extension中使用
- 打开Visual Studio Code。
- 安装Cline插件。
- 配置完成后，在终端中运行：
npm start
在Cursor Editor中使用
- 启动Cursor Editor。
- 打开终端，运行以下命令：
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名称和驱动程序是否正确安装。
📄 许可证
文档未提及相关信息，暂不展示。
参考资料
通过以上步骤，您可以轻松配置和使用mcp-odbc-server，并在各种工具中进行高效的ODBC数据交互。