数据库交互服务器

Altibase MCP Server是一个基于Altibase的数据库交互和业务智能分析服务器,支持SQL查询、业务数据分析和自动生成业务洞察备忘录。

  • by hesslee
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hesslee/mcp-server-altibase

使用说明

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 (string):要执行的SELECT SQL查询
    • 返回:查询结果为对象数组
  • write_query

    • 执行INSERT、UPDATE或DELETE查询
    • 输入:
      • query (string):SQL修改查询
    • 退货: { affected_rows: number }
  • create_table

    • 在数据库中创建新表
    • 输入:
      • query (string):CREATE TABLE SQL语句
    • 返回:表创建确认

架构工具

  • list_tables

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

    • 查看特定表的架构信息
    • 输入:
      • table_name (string):要描述的表的名称
    • 返回:包含名称和类型的列定义数组

分析工具

  • append_insight
    • 为备忘录资源添加新的业务见解
    • 输入:
      • insight (string):从数据分析中发现的业务洞察力
    • 返回:确认洞察力添加
    • 触发器更新memo://insights资源

Prereqisite

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

Linux的Unixodbc设置示例

  • 安装:sudo apt-get安装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 ODBC驱动程序在Altibase窗口客户端安装过程中注册。
  • 为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旨在成为pip和venv的快速高效替代品,用于Python包管理和虚拟环境创建。

无git clone的MCP客户端配置示例

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

使用git clone的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许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息,请参阅项目存储库中的LICENSE文件。