Altibase MCP 服务器

概述

• 一个提供数据库交互和商业智能功能的模型上下文协议（MCP）服务器实现，通过Altibase实现。
• 该服务器允许运行SQL查询、分析商业数据并自动生成业务见解备忘录。
• 此源代码托管在 https://github.com/hesslee/mcp-server-altibase
• 此源代码基于 https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite
• 此包上传到 https://pypi.org/project/mcp-server-altibase

组件

资源

该服务器公开一个动态资源：

• memo://insights：一个不断更新的商业见解备忘录，聚合在分析过程中发现的所有见解
  • 使用附言工具添加新见解时自动更新

提示

该服务器提供了一个演示提示：

• mcp-demo：引导用户完成数据库操作的交互式提示
  • 必要参数：topic（字符串）- 要分析的商业领域
  • 自动生成适当的数据库架构和样例数据
  • 引导用户完成分析和见解生成
  • 集成到商业见解备忘录中

工具

该服务器提供六个核心工具：

查询工具

• read_query

  • 执行SELECT查询以从数据库读取数据
  • 输入：
    • query（字符串）：要执行的SELECT SQL查询
  • 返回：查询结果作为对象数组

• write_query

  • 执行INSERT、UPDATE或DELETE查询
  • 输入：
    • query（字符串）：SQL修改查询
  • 返回：{ affected_rows: number }

• create_table

  • 在数据库中创建新表
  • 输入：
    • query（字符串）：CREATE TABLE SQL语句
  • 返回：确认表格已创建

架构工具

• list_tables

  • 获取数据库中所有表的列表
  • 无需输入
  • 返回：表名称数组

• describe_table

  • 查看特定表的架构信息
  • 输入：
    • table_name（字符串）：要描述的表的名称
  • 返回：表的列及其数据类型的详细信息

突变工具

• execute_trigger
  • 执行数据库中的触发器
  • 输入：
    • trigger_name（字符串）：要执行的触发器的名称
  • 返回：操作结果的状态

先决条件

要使用此MCP服务器，您需要以下先决条件：

1. Python 3.6或更高版本
2. Altibase 数据库安装：请参阅Altibase文档进行安装和配置。
3. ODBC 驱动程序：确保系统上安装了与Altibase兼容的ODBC驱动程序。

Unixodbc 设置示例（Linux）

安装unixodbc

在基于Debian的系统上：

sudo apt-get install unixodbc-dev

在基于Red Hat的系统上：

sudo yum install unixODBC-devel

配置odbc.ini

创建或编辑/etc/odbc.ini文件，添加以下内容：

[Altibase_DSN]
Description = Altibase ODBC Driver
Driver      = /usr/lib/x86_64-linux-gnu/odbc/altibase.so
Database    = your_database_name
User        = your_username
Password    = your_password

Odbc 配置示例（Windows）

安装ODBC驱动程序

1. 下载并安装Altibase的ODBC驱动程序。
2. 将驱动程序添加到系统路径中。

创建DSN

1. 打开“控制面板” > “系统和安全” > “管理工具” > “数据源（ODBC）”。
2. 点击“添加”按钮，选择Altibase ODBC驱动程序。
3. 填写DSN名称和其他必要的信息。

与Claude Desktop 的使用

使用uv

1. 安装并运行Claude Desktop。
2. 在终端中输入以下命令：

   uv --directory /path/to/repo clone hess/mcp-server-altibase
   

3. 然后运行：

   uv --directory /path/to/repo run mcp-server-altibase --odbc-dsn "your_dsn_name"
   

使用uvx

1. 在终端中输入以下命令：

   uvx hess/mcp-server-altibase run -- odbc-dsn="your_dsn_name"