Сервер MCP документации SFML 3.1.0 (sfml3-ref)

Официальный сервер Model Context Protocol (MCP), предоставляющий ИИ-ассистентам (Claude Desktop, Cursor, Claude Code, Cline и т.д.) прямой офлайн-доступ к полной справочной документации по C++ для SFML 3.1.0.

🌟 Возможности

• Чистая справочная документация в Markdown: HTML-документация Doxygen разбирается и очищается в форматированный Markdown для GitHub с подсветкой синтаксиса C++ в блоках кода.

• Полные сигнатуры C++20: Полные прототипы методов с спецификаторами ([[nodiscard]], constexpr, explicit, delete, аргументы по умолчанию).

• Категоризация по модулям: Все 155+ символов распределены по 5 модулям SFML: System, Window, Graphics, Audio и Network.

• Быстрый поиск в памяти: Поиск за доли миллисекунды по именам символов, функциям-членам, параметрам и описаниям.

• Умные псевдонимы: Прямое разрешение распространённых typedef и вспомогательных типов SFML (например, Vector2f ➔ sf::Vector2<T>, IntRect ➔ sf::Rect<T>, seconds ➔ sf::Time).

Related MCP server: godot-mcp-docs

🛠️ Инструменты MCP

🚀 Начало работы

Предварительные требования

• Node.js (рекомендуется v18.0.0 или выше)

• npm

Установка и сборка

# 1. Clone the repository
git clone https://github.com/Floxius/sfml3-ref.git
cd sfml3-ref

# 2. Install dependencies
npm install

# 3. Build the TypeScript server
npm run build

Примечание: Репозиторий уже включает предварительно собранный index.json (~1 МБ), поэтому вам не нужно загружать исходные HTML-файлы Doxygen SFML, если вы не хотите повторно запускать скрипт индексации.

🖥️ Конфигурация клиента

1. Claude Desktop

Добавьте сервер в файл конфигурации Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/sfml3-ref/dist/src/index.js"
      ]
    }
  }
}

(В Windows используйте прямые слэши или двойные обратные слэши, например C:/Users/<username>/Documents/sfml3-ref/dist/src/index.js)

Альтернатива: запуск напрямую с помощью tsx (без шага сборки)

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/ABSOLUTE/PATH/TO/sfml3-ref/src/index.ts"
      ]
    }
  }
}

2. Cursor / Cline / Другие MCP-клиенты

Добавьте STDIO MCP-сервер с:

• Команда: node

• Аргументы: ["/path/to/sfml3-ref/dist/src/index.js"]

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

После подключения в Claude или вашем MCP-клиенте вы можете задавать такие запросы, как:

• "Перечисли все модули, доступные в SFML 3.1."

• "Покажи все классы и функции в модуле Graphics SFML."

• "Какова сигнатура конструктора для sf::Sprite в SFML 3?"

• "Как запросить DNS-записи с помощью sf::Dns в SFML 3.1?"

• "Найди методы обработки событий в SFML 3."

🔄 Пересборка индекса (необязательно)

Если вы хотите заново сгенерировать index.json с нуля:

1. Загрузите HTML-документацию Doxygen для SFML 3.1.0 с веб-сайта SFML.

2. Извлеките HTML-файлы в папку с именем SFML-3.1.0 в корне репозитория.

3. Запустите скрипт индексации:

npm run build:index

📄 Лицензия

• Код сервера: Лицензирован в соответствии с лицензией MIT.

• Документация и библиотека SFML: Авторские права © Laurent Gomila и команда SFML. SFML распространяется на условиях лицензии zlib/png.