Mcp Server Altibase

🚀 Altibase MCP 服务器

Altibase MCP 服务器是一个基于 Altibase 实现的模型上下文协议（MCP）服务器，它提供数据库交互和商业智能功能。该服务器允许用户运行 SQL 查询、分析商业数据，并自动生成业务见解备忘录。其源代码托管在 GitHub，基于 此项目 开发，且已上传到 PyPI。

✨ 主要特性

• 支持运行 SQL 查询，可对商业数据进行分析。
• 自动生成业务见解备忘录，聚合分析过程中的所有见解。
• 提供动态资源和演示提示，方便用户操作。
• 具备多个核心工具，涵盖查询、架构和突变等功能。

📦 安装指南

先决条件

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

📚 详细文档

组件

资源

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

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