MCP-сервер ODBC через PyODBC

Легкий сервер MCP (Model Context Protocol) для ODBC, созданный с помощью FastAPI и pyodbc . Этот сервер совместим с Virtuoso DBMS и другими бэкэндами СУБД, имеющими драйвер ODBC.

Функции

• Получить схемы : извлечь и составить список всех имен схем из подключенной базы данных.

• Получить таблицы : извлечь информацию о таблицах для определенных схем или всех схем.

• Опишите таблицу : создайте подробное описание структур таблиц, включая:

  • Имена столбцов и типы данных

  • Атрибуты, допускающие значение NULL

  • Первичные и внешние ключи

• Поиск таблиц : фильтрация и извлечение таблиц на основе подстрок имен.

• Выполнение хранимых процедур : в случае Virtuoso выполнение хранимых процедур и получение результатов.

• Выполнение запросов :

  • Формат результата JSONL: оптимизирован для структурированных ответов.

  • Формат таблицы Markdown: идеально подходит для составления отчетов и визуализации.

Предпосылки

1. Установить УФ :

   pip install uv

   Или используйте Homebrew:

   brew install uv

2. Проверки среды выполнения unixODBC :

3. Проверьте конфигурацию установки (т.е. расположение ключевых INI-файлов), выполнив: odbcinst -j

4. Выведите список доступных имен источников данных, выполнив команду: odbcinst -q -s

5. Настройка ODBC DSN : Настройте имя источника данных ODBC ( ~/.odbc.ini ) для целевой базы данных. Пример для СУБД Virtuoso:

   [VOS] Description = OpenLink Virtuoso Driver = /path/to/virtodbcu_r.so Database = Demo Address = localhost:1111 WideAsUTF16 = Yes

Установка

Клонируйте этот репозиторий:

Переменные среды

Обновите свой .env , переопределив значения по умолчанию в соответствии со своими предпочтениями.

Конфигурация

Для пользователей Claude Desktop : добавьте следующее в claude_desktop_config.json :

Использование

Предоставляемые инструменты

После успешной установки клиентским приложениям MCP будут доступны следующие инструменты.

Обзор

Подробное описание

• podbc_get_schemas

  • Извлечь и вернуть список всех имен схем из подключенной базы данных.

  • Входные параметры:

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает массив строк JSON с именами схем.

• podbc_get_tables

  • Извлечь и вернуть список, содержащий информацию о таблицах в указанной схеме. Если схема не указана, используется схема соединения по умолчанию.

  • Входные параметры:

    • schema (строка, необязательно): Схема базы данных для фильтрации таблиц. По умолчанию используется соединение по умолчанию.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает строку JSON, содержащую информацию о таблице (например, TABLE_CAT, TABLE_SCHEM, TABLE_NAME, TABLE_TYPE).

• podbc_filter_table_names

  • Фильтрует и возвращает информацию о таблицах, имена которых содержат определенную подстроку.

  • Входные параметры:

    • q (строка, обязательно): подстрока для поиска в именах таблиц.

    • schema (строка, необязательно): Схема базы данных для фильтрации таблиц. По умолчанию используется соединение по умолчанию.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает строку JSON, содержащую информацию для сопоставления таблиц.

• podbc_describe_table

  • Извлечение и возврат подробной информации о столбцах определенной таблицы.

  • Входные параметры:

    • schema (строка, обязательно): имя схемы базы данных, содержащей таблицу.

    • table (строка, обязательно): Имя таблицы, которую нужно описать.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает строку JSON, описывающую столбцы таблицы (например, COLUMN_NAME, TYPE_NAME, COLUMN_SIZE, IS_NULLABLE).

• podbc_query_database

  • Выполнить стандартный SQL-запрос и вернуть результаты в формате JSON.

  • Входные параметры:

    • query (строка, обязательно): Строка SQL-запроса для выполнения.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результаты запроса в виде строки JSON.

• podbc_query_database_md

  • Выполнить стандартный SQL-запрос и вернуть результаты, отформатированные в виде таблицы Markdown.

  • Входные параметры:

    • query (строка, обязательно): Строка SQL-запроса для выполнения.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результаты запроса в виде строки таблицы Markdown.

• podbc_query_database_jsonl

  • Выполнить стандартный SQL-запрос и вернуть результаты в формате строк JSON (JSONL) (один объект JSON на строку).

  • Входные параметры:

    • query (строка, обязательно): Строка SQL-запроса для выполнения.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результаты запроса в виде строки JSONL.

• podbc_spasql_query

  • Выполнить запрос SPASQL (гибрид SQL/SPARQL) и получить результаты. Это специфическая функция Virtuoso.

  • Входные параметры:

    • query (строка, обязательно): строка запроса SPASQL.

    • max_rows (число, необязательно): Максимальное количество возвращаемых строк. По умолчанию 20.

    • timeout (число, необязательно): Время ожидания запроса в миллисекундах. По умолчанию 30000.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результат вызова базовой хранимой процедуры (например, Demo.demo.execute_spasql_query ).

• podbc_sparql_query

  • Выполнить запрос SPARQL и вернуть результаты. Это специфическая функция Virtuoso.

  • Входные параметры:

    • query (строка, обязательно): строка запроса SPARQL.

    • format (строка, необязательно): Желаемый формат результата. По умолчанию 'json'.

    • timeout (число, необязательно): Время ожидания запроса в миллисекундах. По умолчанию 30000.

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результат вызова базовой функции (например, "UB".dba."sparqlQuery" ).

• podbc_virtuoso_support_ai

  • Использует функцию AI Assistant, специфичную для Virtuoso, передавая подсказку и необязательный ключ API. Это специфичная для Virtuoso функция.

  • Входные параметры:

    • prompt (строка, обязательно): текст подсказки для функции ИИ.

    • api_key (строка, необязательно): API-ключ для службы AI. По умолчанию "none".

    • user (строка, необязательно): Имя пользователя базы данных. По умолчанию "demo".

    • password (строка, необязательно): Пароль базы данных. По умолчанию "demo".

    • dsn (строка, необязательно): Имя источника данных ODBC. По умолчанию "Local Virtuoso".

  • Возвращает результат вызова функции AI Support Assistant (например, DEMO.DBA.OAI_VIRTUOSO_SUPPORT_AI ).

Поиск неисправностей

Для облегчения устранения неполадок:

1. Установите MCP Inspector:

   npm install -g @modelcontextprotocol/inspector

2. Запустите инспектор:

   npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-pyodbc-server run mcp-pyodbc-server

Для устранения неполадок взаимодействия с сервером перейдите по предоставленному URL-адресу.