Исходник Софт Arizona Forum MCP Server

fakelag28 · Вчера в 14:53

Arizona Forum MCP Server

Реализация сервера MCP (Model Context Protocol), предоставляющая LLM-моделям возможность напрямую взаимодействовать с форумом Arizona RP (forum.arizona-rp.com) через асинхронную библиотеку arizona-forum-api-async.

Сервер предоставляет набор инструментов для чтения, поиска, публикации сообщений, модерирования тем и работы с профилями пользователей форума.

github.com/Arizona-AI/MCP-Arizona-Forum-API

🛠 Доступные инструменты (Tools)

После подключения сервера к вашему LLM-клиенту будут доступны следующие инструменты:

get_member_info — Получение информации о профиле пользователя (роли, аватар, кол-во сообщений, реакций).
search_members — Поиск пользователей по части никнейма.
manage_member — Подписка (follow) или добавление пользователя в игнор (ignore).
get_category_info — Получение информации о разделе форума (опционально со статистикой).
get_category_threads — Чтение списка тем в категории (закрепленных и обычных) на указанной странице.
create_thread — Создание новой темы (топика) в разделе.
get_thread_info — Получение мета-информации о теме и первого поста.
get_thread_posts — Возвращает список ID всех сообщений на конкретной странице темы.
answer_thread — Публикация нового сообщения (ответа) в существующей теме.
manage_thread_status — Управление темой: закрытие/открытие, закрепление/открепление, удаление, смена названия.
get_post_info — Чтение содержимого конкретного поста по ID (с поддержкой конвертации в BB-Code).
manage_post — Редактирование, удаление, установка реакций или добавление поста в закладки.
manage_profile_wall — Взаимодействие со стеной профиля (чтение, запись постов, удаление, комментирование).
search_forum_threads — Полнотекстовый поиск тем по всему форуму (с фильтрацией по автору).
get_notifications — Получение списка уведомлений (с возможностью пометить как прочитанные).
send_forum_form — Заполнение и отправка встроенных веб-форм форума.

Аутентификация и настройка

Поскольку эта библиотека имитирует действия залогиненного пользователя, вам потребуются Cookie из вашей браузерной сессии на forum.arizona-rp.com:

Как их получить:

Войдите в свой форумный аккаунт на forum.arizona-rp.com;
Установите двухфакторную аутентификацию и перезайдите в свой аккаунт;
Установите расширение "Cookie Editor", после чего с его помощью получите следующие значения:
- xf_tfa_trust
- xf_user

Переменные окружения:
Для работы сервера необходимо настроить следующие переменные окружения:

ARIZONA_FORUM_COOKIE — Строка кук в формате xf_tfa_trust=ЗНАЧЕНИЕ; xf_user=ЗНАЧЕНИЕ.
ARIZONA_USER_AGENT — (Опционально) Браузерный User-Agent. Если не указан, используется стандартное значение по умолчанию.

Установка зависимостей

Перед запуском убедитесь, что у вас установлены необходимые пакеты:

Bash:

pip install mcp arizona-forum-api-async

Подключение к MCP-клиентам

1. LM Studio

Интеграция протестирована и подтвердила корректную работу в приложении LM Studio.

Откройте LM Studio и перейдите в раздел MCP (на панели слева).
Нажмите кнопку Add Server (Добавить сервер).
Заполните параметры конфигурации:

JSON:

{
  "mcpServers": {
    "arizona-forum-server": {
      "command": "python",
      "args": [
        "/абсолютный/путь/к/вашему/mcp_server.py"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "ARIZONA_FORUM_COOKIE": "xf_tfa_trust=ВАШЕ_ЗНАЧЕНИЕ; xf_user=ВАШЕ_ЗНАЧЕНИЕ",
        "ARIZONA_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36"
      }
    }
  }
}

Сохраните конфигурацию и запустите сервер. В логах должно отобразиться успешное подключение.

Примечание по тестированию моделей:
Было произведено тестирование работы данного MCP-сервера на LLM-модели gemma-4-e4b-uncensored-hauhaucs-aggressive внутри LM Studio. Тестирование показало стабильный вызов инструментов, корректное сопоставление аргументов и успешное выполнение запросов к API форума через модель.

2. Claude Desktop

Для подключения сервера к Claude Desktop добавьте конфигурацию в файл настроек claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Добавьте следующую запись в блок mcpServers:

JSON:

{
  "mcpServers": {
    "arizona-forum-server": {
      "command": "python",
      "args": [
        "/абсолютный/путь/к/вашему/mcp_server.py"
      ],
      "env": {
        "ARIZONA_FORUM_COOKIE": "xf_tfa_trust=ВАШЕ_ЗНАЧЕНИЕ; xf_user=ВАШЕ_ЗНАЧЕНИЕ",
        "ARIZONA_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36"
      }
    }
  }
}

После сохранения файла перезапустите Claude Desktop. В правом нижнем углу окна чата появится иконка в виде вилки/розетки, подтверждающая доступность инструментов сервера.

3. Claude Code

Инструмент командной строки Claude Code также поддерживает подключение внешних MCP-серверов.

Чтобы добавить данный сервер в конфигурацию Claude Code, выполните команду в терминале:

Bash:

claude mcp add arizona-forum-server -- python /путь/к/mcp_server.py

Альтернативно, вы можете настроить его через конфигурационный файл Claude Code, добавив переменные окружения ARIZONA_FORUM_COOKIE и ARIZONA_USER_AGENT в системное окружение перед инициализацией сессии.

Этот проект лицензирован под лицензией AGPL-3.0.

Поиск

Поиск

Исходник Софт Arizona Forum MCP Server

fakelag28

Участник

Similar threads