Ghostfolio MCP — MCP-сервер для Claude Code: установка
Подключает AI-агента к Ghostfolio для анализа портфеля, рыночных данных и управления операциями.
claude mcp add --env GHOSTFOLIO_URL=<GHOSTFOLIO_URL> --env GHOSTFOLIO_TOKEN=<GHOSTFOLIO_TOKEN> --env GHOSTFOLIO_VERIFY_SSL=<GHOSTFOLIO_VERIFY_SSL> --env GHOSTFOLIO_TIMEOUT=<GHOSTFOLIO_TIMEOUT> --env READ_ONLY_MODE=<READ_ONLY_MODE> --transport stdio ghostfolio-mcp -- uvx ghostfolio-mcpЧто делает Ghostfolio MCP
Ghostfolio MCP подключает AI-агента к экземпляру Ghostfolio через MCP. Сервер даёт доступ к составу портфеля, позициям, доходности, дивидендам, распределению активов и историческим ценам. Также он умеет искать финансовые символы и просматривать балансы, ордера и транзакции.
Сервер написан на Python и поддерживает чтение и изменение данных. Через переменные GHOSTFOLIO_URL и GHOSTFOLIO_TOKEN задаётся подключение, а READ_ONLY_MODE запрещает операции записи. Доступны настройки SSL, тайм-аутов, лимитов запросов и фильтрации инструментов.
Нужны Python 3.11 to 3.15, доступ к экземпляру Ghostfolio и действующий API-токен. Без токена Ghostfolio сервер не подключится.
Какие задачи решает
- анализировать состав и доходность портфеля
- получать дивиденды и распределение активов
- отслеживать ордера, транзакции и балансы
- искать акции, ETF и другие символы
- импортировать транзакции из другой платформы
Примеры запросов агенту
- Проанализируй доходность моего портфеля Ghostfolio за выбранный период.
- Покажи дивиденды, распределение активов и сравнение с бенчмарком.
- Создай транзакцию в Ghostfolio и проверь результат.
Как установить Ghostfolio MCP
Командой платформы
claude mcp add --env GHOSTFOLIO_URL=<GHOSTFOLIO_URL> --env GHOSTFOLIO_TOKEN=<GHOSTFOLIO_TOKEN> --env GHOSTFOLIO_VERIFY_SSL=<GHOSTFOLIO_VERIFY_SSL> --env GHOSTFOLIO_TIMEOUT=<GHOSTFOLIO_TIMEOUT> --env READ_ONLY_MODE=<READ_ONLY_MODE> --transport stdio ghostfolio-mcp -- uvx ghostfolio-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from ghostfolio-mcp <команда>
Командой платформы
codex mcp add ghostfolio-mcp --env GHOSTFOLIO_URL=<GHOSTFOLIO_URL> --env GHOSTFOLIO_TOKEN=<GHOSTFOLIO_TOKEN> --env GHOSTFOLIO_VERIFY_SSL=<GHOSTFOLIO_VERIFY_SSL> --env GHOSTFOLIO_TIMEOUT=<GHOSTFOLIO_TIMEOUT> --env READ_ONLY_MODE=<READ_ONLY_MODE> -- uvx ghostfolio-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from ghostfolio-mcp <команда>
Файл настроек
{
"mcpServers": {
"ghostfolio-mcp": {
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<GHOSTFOLIO_URL>",
"GHOSTFOLIO_TOKEN": "<GHOSTFOLIO_TOKEN>",
"GHOSTFOLIO_VERIFY_SSL": "<GHOSTFOLIO_VERIFY_SSL>",
"GHOSTFOLIO_TIMEOUT": "<GHOSTFOLIO_TIMEOUT>",
"READ_ONLY_MODE": "<READ_ONLY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from ghostfolio-mcp <команда>
Файл настроек
{
"servers": {
"ghostfolio-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ghostfolio-mcp"
],
"env": {
"GHOSTFOLIO_URL": "<GHOSTFOLIO_URL>",
"GHOSTFOLIO_TOKEN": "<GHOSTFOLIO_TOKEN>",
"GHOSTFOLIO_VERIFY_SSL": "<GHOSTFOLIO_VERIFY_SSL>",
"GHOSTFOLIO_TIMEOUT": "<GHOSTFOLIO_TIMEOUT>",
"READ_ONLY_MODE": "<READ_ONLY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from ghostfolio-mcp <команда>
Командой платформы
gemini mcp add -e GHOSTFOLIO_URL=<GHOSTFOLIO_URL> -e GHOSTFOLIO_TOKEN=<GHOSTFOLIO_TOKEN> -e GHOSTFOLIO_VERIFY_SSL=<GHOSTFOLIO_VERIFY_SSL> -e GHOSTFOLIO_TIMEOUT=<GHOSTFOLIO_TIMEOUT> -e READ_ONLY_MODE=<READ_ONLY_MODE> ghostfolio-mcp uvx ghostfolio-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from ghostfolio-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Ghostfolio MCP
Как установить Ghostfolio MCP в Claude Code?
Укажи адрес Ghostfolio и API-токен вместо плейсхолдеров, затем выполни claude mcp add ghostfolio-mcp -e GHOSTFOLIO_URL=<GHOSTFOLIO_URL> -e GHOSTFOLIO_TOKEN=<GHOSTFOLIO_TOKEN> -- uvx ghostfolio-mcp.
Что делает Ghostfolio MCP?
Он даёт AI-агенту доступ к данным и операциям Ghostfolio: портфелю, рыночным данным, транзакциям, счетам и настройкам.
Можно ли запретить изменение данных?
Да. Переменная READ_ONLY_MODE отключает операции записи, включая создание и удаление данных.
