Финансовый MCP-сервер
Пользовательский сервер Model Context Protocol (MCP) для расширенного финансового анализа, мониторинга акций и рыночной разведки в реальном времени. Этот сервер предоставляет набор инструментов и конечных точек API для управления портфелем, рыночных сводок, оповещений о акциях и контекстных финансовых идей, разработанных для бесшовной интеграции с Claude Desktop и другими MCP-совместимыми клиентами.
Основные характеристики
Мониторинг цен акций в режиме реального времени : отслеживайте и оповещайте о движении цен для определенных пользователем акций и пороговых значений.
Управление портфелем : добавляйте, удаляйте и просматривайте отслеживаемые акции в постоянном портфеле.
Сводки по рынку : получайте актуальные данные по мировому рынку, включая индексы, лидеры роста/падения и заголовки новостей.
Контекстная финансовая аналитика : анализируйте запросы пользователей, извлекайте финансовые данные, извлекайте и обобщайте соответствующие новости, а также генерируйте полезные подсказки.
Автоматические оповещения : получайте уведомления Telegram о ценовых порогах, торговых возможностях и системных ошибках.
Настраиваемая конфигурация : конфигурация секторов и акций на основе JSON для гибкого оповещения.
Надежное ведение журналов и обработка ошибок : подробные журналы и сообщения об ошибках для прозрачности и устранения неполадок.
Related MCP server: MCP Server
Обзор системы
Основные конечные точки и инструменты
финансовый_контекст(запрос: str)
Извлекает тикеры и ключевые слова из пользовательского запроса, выбирает и обобщает соответствующие новости, а также возвращает структурированный контекст и подсказку для последующего анализа.
market_summary()
Возвращает актуальную сводку мировых рынков, включая индексы, лидеры движения и заголовки новостей.
получить_портфолио()
Возвращает текущий список отслеживаемых акций в портфеле пользователя.
add_stock(тикер: str) / remove_stock(тикер: str)
Добавить или удалить акцию из портфеля с аннулированием кэша и проверкой.
portfolio_alerts(случайная_строка: str)
Возвращает все сработавшие оповещения для портфеля или для определенного тикера, если он указан.
check_stock_alerts(тикер: str) / single_stock_alert(тикер: str)
Возвращает оповещения для определенных акций с подробной обработкой ошибок.
Автоматическое оповещение
Интеграция с Telegram : отправляет форматированные оповещения и сводки в настроенный чат Telegram.
Торговые возможности : обнаруживает и уведомляет о действенных торговых сигналах.
Контекстное обобщение
News Summarizer : использует местную степень магистра права (Ollama/Mistral) для создания подробных, с тегами настроений, резюме статей финансовых новостей.
Конструктор подсказок : создает подсказку, учитывающую потребности рынка, для использования последующими магистрами права или помощниками.
Структура файла
config/
alerts_config.json # Main alert configuration (sector/ticker/thresholds)
tech_alerts_config.json # Tech sector-specific alerts
services/
alerts.py # Core alert logic
tech_alerts.py # Tech sector alert logic
telegram_alerts.py # Telegram integration
market_summary.py # Market data and news
summarizer.py # News summarization (LLM)
fetcher.py # Web data fetching
context_builder.py # Prompt/context construction
intent_parser.py # Financial entity extraction
portfolio.py # Portfolio management
server.py # MCP server entry point and API definitions
requirements.txt # Python dependenciesКонфигурация и настройка
Конфигурация оповещений ( config/alerts_config.json )
Организуйте акции по секторам с настраиваемыми верхними/нижними ценовыми порогами и описаниями.
Пример структуры:
{
"Tech Giants": {
"AAPL": {"above": 200, "below": 180, "description": "Apple Inc."}
},
"Financial": {
"JPM": {"above": 160, "below": 140, "description": "JPMorgan Chase"}
}
}Переменные среды
Установите их в файле .env или в системной среде:
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
SERPAPI_API_KEY=your_serpapi_keyУстановка и запуск с рабочего стола Claude
Предпосылки
Питон 3.7+
Claude Desktop (или любой MCP-совместимый клиент)
Учетные данные бота Telegram (для оповещения)
Подключение к Интернету (для рыночных/новостных данных)
Пошаговое руководство
Клонировать репозиторий
git clone <this-repo-url> cd Finance_MCP_ServerСоздать и активировать виртуальную среду
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activateУстановить зависимости
pip install -r requirements.txtНастроить переменные среды
Создайте файл
.envв корне проекта с вашими ключами API и токенами:TELEGRAM_BOT_TOKEN=your_bot_token TELEGRAM_CHAT_ID=your_chat_id SERPAPI_API_KEY=your_serpapi_key
Изменить конфигурации оповещений
Измените
config/alerts_config.jsonиconfig/tech_alerts_config.jsonчтобы задать акции, сектора и пороговые значения.
Установите MCP Server с помощью CLI
Используйте MCP CLI для установки и регистрации сервера для Claude Desktop:
mcp install server.py --name "Financial MCP Server"Это зарегистрирует сервер как пользовательский инструмент MCP, что сделает его доступным для обнаружения Claude Desktop и другими клиентами MCP.
Запустите MCP Server через MCP CLI
Запустите сервер с помощью MCP CLI:
mcp run server.pyСервер запустится и будет прослушивать запросы MCP через stdio.
Подключайтесь с рабочего стола Claude
В Claude Desktop добавьте новое пользовательское подключение к серверу MCP.
Установите исполняемый файл/команду на
mcp run server.py(или выберите зарегистрированный «Financial MCP Server» из списка MCP CLI).Claude Desktop будет взаимодействовать с сервером с использованием протокола MCP, что позволит использовать все описанные инструменты и конечные точки.
Пример: конфигурация сервера Claude Desktop MCP
После установки и регистрации Financial MCP Server вы можете добавить его в конфигурацию Claude Desktop. Вот пример фрагмента claude_desktop_config.json :
{
"mcpServers": {
"Financial-MCP-Server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"server.py"
],
"env": {
"SERPAPI_API_KEY": "",
"TELEGRAM_BOT_TOKEN": "",
"TELEGRAM_USER_ID": "",
"OPENAI_API_KEY": "",
"ALPHA_VANTAGE_API_KEY": ""
}
}
}
}При необходимости обновите раздел
env, указав фактические ключи API и токены.Такая конфигурация гарантирует, что Claude Desktop сможет запускаться и взаимодействовать с вашим сервером Financial MCP, используя правильную среду и аргументы командной строки.
Использование инструментов в Claude Desktop
После установки и подключения вашего пользовательского сервера Financial MCP все доступные инструменты автоматически появятся в меню инструментов Claude Desktop. Вы можете включать или отключать каждый инструмент по отдельности, что упрощает доступ к таким функциям, как анализ финансового контекста, сводки рынка, управление портфелем и оповещения о состоянии акций непосредственно из интерфейса Claude.
Ниже представлен снимок экрана, показывающий, как инструменты с вашего сервера MCP будут перечислены и переключены в Claude Desktop:
Каждый инструмент (например,
financial_context,market_summary,add_stockи т. д.) можно включить или отключить по мере необходимости.Эта бесшовная интеграция позволяет вам взаимодействовать с вашим сервером финансового анализа, используя естественный язык и рабочие процессы на основе инструментов в Claude Desktop.
Примеры использования
Получить сводку рынка : используйте инструмент
market_summaryдля получения текущих индексов, движущих факторов и новостей.Управление портфелем : используйте
add_stock,remove_stockиget_portfolioдля обновления и просмотра отслеживаемых акций.Получайте оповещения : настройте пороговые значения и получайте уведомления Telegram об изменениях цен и торговых возможностях.
Контекстный анализ : используйте
financial_contextдля анализа запроса, извлечения тикеров и получения сводных новостей и подсказок с информацией о рынке.
Устранение неполадок и журналы
Все журналы записываются в файл
financial_mcp.logв корне проекта.Для отладки проверьте файл журнала и убедитесь, что переменные среды и файлы конфигурации верны.
Если у вас возникли проблемы с Telegram или получением новостей, проверьте ключи API и подключение к интернету.
