MCP Server Altibase

🚀 Altibase MCP 服务器

Altibase MCP 服务器是一个基于 Altibase 实现的模型上下文协议（MCP）服务器，它提供数据库交互和商业智能功能。借助该服务器，用户可以运行 SQL 查询、分析商业数据，并自动生成业务见解备忘录。此服务器的源代码托管在 GitHub 上，同时也作为 Python 包上传到了 PyPI。

🚀 快速开始

要使用此 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

在终端中输入以下命令：

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

✨ 主要特性

• 提供数据库交互和商业智能功能，允许运行 SQL 查询、分析商业数据并自动生成业务见解备忘录。
• 公开动态资源 memo://insights，可自动更新商业见解备忘录。
• 提供演示提示 mcp-demo，引导用户完成数据库操作。
• 提供六个核心工具，涵盖查询、架构和突变等功能。

📚 详细文档

组件

资源

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

• 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（字符串）：要执行的触发器的名称。
  • 返回：操作结果的状态。

其他信息

• 此源代码托管在 https://github.com/hesslee/mcp-server-altibase
• 此源代码基于 https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite
• 此包上传到 https://pypi.org/project/mcp-server-altibase