forge — MCP-сервер для Claude Code: эмбеддинги текста
Даёт агенту инструменты Forge для преобразования текста в векторы и просмотра доступных моделей. Пригодится для подготовки эмбеддингов документов или поисковых запросов.
claude mcp add forge -e FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcpЧто делает forge
Сервер подключает API эмбеддингов Forge к MCP-клиенту. Инструмент embed возвращает векторы для одного текста или набора; list_models показывает доступные модели и их размерности. Для поиска можно передавать input_type: "query", а для индексируемых материалов — input_type: "document".
Нужны Node.js версии 18 или новее и ключ Forge API в FORGE_API_KEY. Можно выбрать turbo, pro или ultra, а параметром dim уменьшить размер вектора. Сервер не хранит отправленный текст и выданные векторы, но записывает число токенов для биллинга. Сам по себе он не выполняет поиск и не хранит документы, поэтому для RAG понадобятся отдельные компоненты.
Какие задачи решает
- получить векторы для документов и поисковых запросов
- посмотреть доступные модели и их размерности
- сравнить два текста по эмбеддингам
- уменьшить размерность векторов параметром
dim
Примеры запросов агенту
- Преобразуй содержимое
docs/guide.mdв векторы с помощью Forge. - Создай эмбеддинг для этого поискового запроса через Forge.
- Покажи модели Forge и их размерности.
Как установить forge
Командой платформы
claude mcp add forge -e FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add forge --env FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"forge": {
"command": "npx",
"args": [
"-y",
"@voxell/forge-mcp"
],
"env": {
"FORGE_API_KEY": "<FORGE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"forge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@voxell/forge-mcp"
],
"env": {
"FORGE_API_KEY": "<FORGE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FORGE_API_KEY=<FORGE_API_KEY> forge npx -y @voxell/forge-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о forge
Как установить forge в Claude Code?
Выполните claude mcp add forge -e FORGE_API_KEY=<FORGE_API_KEY> -- npx -y @voxell/forge-mcp. Либо используйте альтернативную команду: claude mcp add --env FORGE_API_KEY=<FORGE_API_KEY> --transport stdio forge -- npx -y @voxell/forge-mcp.
Что делает forge?
Подключает к MCP инструменты Forge для преобразования текста в векторы и просмотра моделей. Поиск и хранение данных в его задачи не входят.
Что нужно для работы forge?
Нужны Node.js версии 18 или новее и ключ Forge API, переданный через FORGE_API_KEY.