Altibase MCP Server

Altibase MCP 服务

概述

• 一个 Model Context Protocol（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：持续更新的业务洞察备忘录，用于汇总分析期间发现的洞察
  • 通过 append-insight 工具发现新洞察时自动更新

提示词

此服务提供一个演示提示词：

• 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（字符串）：要描述的表名
  • 返回：包含名称和类型的列定义数组

分析工具

• append_insight
  • 向备忘录资源中添加新的业务洞察
  • 输入：
    • insight（字符串）：从数据分析中发现的业务洞察
  • 返回：洞察添加确认信息
  • 触发 memo://insights 资源更新

前置条件

• 从 http://support.altibase.com/en/product 下载并安装 Altibase 服务端和客户端
• Linux 的 Unixodbc 设置
• Windows 的 ODBC DSN 设置

Linux 的 Unixodbc 设置示例

• 安装：sudo apt-get install unixodbc-dev
• 配置示例：

$ cat /etc/odbc.ini 
[PYODBC]
Driver          = /home/hess/work/altidev4/altibase_home/lib/libaltibase_odbc-64bit-ul64.so
Database        = mydb
ServerType      = Altibase
Server          = 127.0.0.1
Port            = 21121
UserName        = SYS
Password        = MANAGER
FetchBuffersize = 64
ReadOnly        = no

$ cat /etc/odbcinst.ini 
[ODBC]
Trace=Yes
TraceFile=/tmp/odbc_trace.log

Windows 的 ODBC DSN 设置示例

• Altibase Windows 客户端安装过程中会注册 Altibase Windows ODBC 驱动程序。
• 为 Altibase 添加一个 ODBC DSN。
• 配置示例：

[Altibase Connection Config]
Windows DSN Name: PYODBC
host(name or IP): 192.168.1.210
Port(default 20300): 21121
User: SYS
Password: MANAGER
Database: mydb
NLS_USE: UTF-8

与 Claude Desktop 搭配使用

• 安装 Claude 桌面版。

uv

• 安装 uv
• uv 旨在成为 pip 和 venv 的快速、高效替代方案，用于 Python 软件包管理和虚拟环境创建。

未克隆 git 时的 MCP 客户端配置示例

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "altibase": {
    "command": "uvx",
    "args": [
      "mcp-server-altibase@latest",
      "--odbc-dsn",
      "PYODBC"
    ]
  }
}

克隆 git 时的 MCP 客户端配置示例

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "altibase": {
    "command": "uv",
    "args": [
      "--directory",
      "path/to/repository/directory",
      "run",
      "mcp-server-altibase",
      "--odbc-dsn",
      "PYODBC"
    ]
  }
}

许可证

此 MCP 服务采用 MIT License 许可。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。