Сервер Confluence MCP

Сервер Model Context Protocol (MCP) для взаимодействия с Confluence Data Center через REST API. Этот сервер предоставляет набор инструментов, которые позволяют моделям ИИ взаимодействовать с контентом Confluence.

Функции

Этот сервер MCP обеспечивает следующие операции для Confluence:

• Выполнение поиска CQL (язык запросов Confluence)

• Получить содержимое страницы по идентификатору

• Получить содержимое страницы с телом

• Найти страницы по клавише пробела

• Найти страницу по названию и клавише пробела

• Создать новые страницы (с необязательной родительской страницей)

• Обновить существующие страницы

• Удалить страницы

Related MCP server: OmniMCP

Установка

1. Клонировать этот репозиторий

2. Установите зависимости:

pip install -r requirements.txt

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

Создайте файл .env в корне проекта со следующими переменными:

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

Отрегулируйте значения в соответствии с вашим экземпляром Confluence.

Запуск сервера

Режим разработки (рекомендуется)

Правильный способ запустить сервер MCP — использовать инструмент MCP CLI в режиме разработки. Это запустит пользовательский интерфейс MCP Inspector, который позволяет вам тестировать и отлаживать сервер:

mcp dev confluence.py

По умолчанию MCP Inspector запустится по адресу http://127.0.0.1:6274 .

Прямое исполнение (не рекомендуется)

Серверы MCP предназначены для запуска с помощью инструмента MCP CLI или интеграции с Claude Desktop. Прямое выполнение с помощью Python не является стандартным способом запуска сервера MCP, но скрипт включает резервный режим для тестирования:

python confluence.py

Однако этот режим имеет ограниченную функциональность и предназначен только для базового тестирования.

Установка в Claude Desktop

Чтобы установить сервер в Claude Desktop:

mcp install confluence.py

Ссылка на API

выполнить_cql_search

Выполните CQL-запрос в Confluence для поиска страниц.

Параметры:

• cql : строка запроса CQL

• limit : Количество возвращаемых результатов (по умолчанию: 10)

получить_страницу_контент

Получите содержимое страницы Confluence.

Параметры:

• pageId : идентификатор страницы Confluence

получить_страницу_с_телом

Получите страницу с основным содержимым.

Параметры:

• pageId : идентификатор страницы Confluence

найти_страницы_по_пространству

Поиск страниц по клавише пробела.

Параметры:

• spaceKey : Клавиша пространства слияния

• limit : Максимальное количество возвращаемых результатов (по умолчанию: 10)

• expand : Необязательный список свойств, разделенных запятыми, для раскрытия.

найти_страницу_по_заголовку

Найдите страницу по названию и клавише пробела.

Параметры:

• title : Заголовок страницы

• spaceKey : Клавиша пространства слияния

создать_страницу

Создайте новую страницу в Confluence.

Параметры:

• title : Заголовок страницы

• spaceKey : Клавиша пространства слияния

• content : Содержимое страницы в формате хранения (HTML)

• parentId : Необязательный идентификатор родительской страницы

обновить_страницу

Обновите существующую страницу в Confluence.

Параметры:

• pageId : идентификатор страницы Confluence

• content : Новый контент страницы в формате хранения (HTML)

• title : Необязательный новый заголовок для страницы

• spaceKey : необязательная клавиша пробела (требуется только при изменении пробела)

удалить_страницу

Удалить страницу по идентификатору.

Параметры:

• pageId : идентификатор страницы Confluence

Пример использования

После того, как сервер запущен и подключен к модели ИИ, вы можете взаимодействовать с Confluence, используя естественный язык. Например:

• «Найти все страницы в области DOCS»

• «Получить содержимое страницы с идентификатором 123456»

• «Создайте новую страницу под названием «Заметки о встрече» в пространстве TEAM с содержимым «Заметки о нашей встрече»»

• «Обновите страницу с идентификатором 123456, чтобы она имела содержимое «Обновленные заметки о встрече»»

• «Изменить заголовок страницы 123456 на «Пересмотренные заметки о собрании»»

Лицензия

Массачусетский технологический институт