okf-mcp — MCP-сервер для Claude Code: что делает и как установить
Локальный сервер для проверки, графовой навигации и поиска по каталогам знаний Open Knowledge Format v0.2 прямо через ИИ-агента.
claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcpЧто делает okf-mcp
Сервер даёт агенту доступ к каталогам знаний OKF v0.2, собранным из файлов Markdown с YAML-метаданными. Инструмент строит граф связей между концептами и индексирует текст в оперативной памяти движком MiniSearch по алгоритму BM25+. Для работы не нужны внешние базы данных, векторные эмбеддинги или облачные сервисы.
При генерации каталогов okf-mcp сверяет манифесты владения: внешние генераторы не могут перезаписать ручные заметки или выйти за пределы своего каталога. Ссылки на код и вычислительные контракты проверяются только статически, поэтому сервер ничего не исполняет в системе.
Для запуска потребуется Node 22 или более свежая версия. По умолчанию сервер работает сугубо локально через stdio без сетевых запросов.
Какие задачи решает
- индексировать локальные каталоги Markdown в формате OKF v0.2 для контекста агента
- искать концепты по ключевым словам через BM25+ без векторных баз
- проверять валидность графа ссылок и метаданных перед коммитом
- защищать ручные документы от перезаписи автоматическими генераторами
Примеры запросов агенту
- Найди в каталоге OKF все концепты, связанные с архитектурой проекта
- Проверь валидность локального бандла знаний в папке
./docs/okf - Покажи граф связей и источники для концепта
overview/okf-mcp
Как установить okf-mcp
Командой платформы
claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcpКомандой платформы
codex mcp add okf-mcp -- npx -y @mfdaves/okf-mcpФайл настроек
{
"mcpServers": {
"okf-mcp": {
"command": "npx",
"args": [
"-y",
"@mfdaves/okf-mcp"
]
}
}
}Файл настроек
{
"servers": {
"okf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mfdaves/okf-mcp"
]
}
}
}Командой платформы
gemini mcp add okf-mcp npx -y @mfdaves/okf-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о okf-mcp
Как установить okf-mcp в Claude Code?
Добавьте сервер одной командой: claude mcp add okf-mcp -- npx -y @mfdaves/okf-mcp.
Зачем нужен okf-mcp?
Он превращает папки с Markdown-документацией стандарта OKF v0.2 в структурированную базу знаний с поиском и графом связей для ассистента.
Какие системные требования нужны для запуска?
В системе должна быть установлена Node 22 или новее. В стандартном режиме сервер работает локально без сетевых запросов и не требует базы данных.
