-
securityA
license-
qualityEnables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
Last updated -
14
3
MIT License
Нексус МКП
Функции
Интеграция с Google Календарем
Создание, чтение, обновление и удаление событий календаря
Список предстоящих событий
Управление хранилищем Obsidian
Создавайте, читайте, обновляйте и удаляйте заметки
Полнотекстовый поиск в заметках
Управление папками (создание, удаление, поиск, список)
Интеграция с Трелло
Управление доской, списком и карточкой
Создание, обновление и удаление карт
Поиск карточек по текстовому запросу
Анализ веб-страницы
Извлечение и очистка HTML-контента из любого URL-адреса
Поиск новостей Google
Поиск последних новостных статей по заданной теме
Присоединяйтесь ко мне в Telegram и блоге
Предпосылки
Python 3.10 или выше
Поэзия (менеджер пакетов Python)
Учетные данные API Календаря Google
Учетные данные API Trello (если используются функции Trello)
Obsidian Vault (при использовании функций Obsidian)
Установка
Клонируйте репозиторий:
git clone https://github.com/yourusername/nexus-mcp.git cd nexus-mcpУстановка зависимостей с помощью Poetry:
poetry installНастройте API Календаря Google:
Перейдите в Google Cloud Console.
Создайте новый проект или выберите существующий
Включить API Календаря Google
Создать учетные данные OAuth 2.0
Загрузите учетные данные и сохраните их как
credentials.jsonв корне проекта.
Настройте Trello API (необязательно):
Перейти на портал разработчиков Trello
Получите свой ключ API и токен
Добавьте их в переменные среды или файл конфигурации.
Конфигурация
Запустите первоначальную настройку для аутентификации в Google Calendar:
poetry run python main.pyОткроется окно браузера для аутентификации Google.
Следуйте инструкциям для авторизации приложения.
Использование
Запустите сервер:
poetry run python main.pyСервер запустится и будет готов принимать клиентские подключения, совместимые с MCP.
Используйте любой MCP-совместимый клиент для взаимодействия с сервером. Сервер предоставляет следующие инструменты:
Управление календарем
Операции хранилища Обсидиан
Управление доской Trello
Анализ веб-страницы
Конфигурация рабочего стола Anthropic Claude
Чтобы использовать этот сервер с Anthropic Claude Desktop, добавьте следующую конфигурацию в настройки Claude Desktop:
{
"mcpServers": {
"personal-assistant": {
"command": "/path/to/your/venv/bin/python",
"args": ["/path/to/your/project/main.py"],
"env": {
"GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json",
"GOOGLE_TOKEN_PATH": "/path/to/your/token.json",
"GOOGLE_API_KEY": "your_google_api_key",
"GOOGLE_CX_ID": "your_google_cx_id",
"OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
"OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
"TRELLO_API_KEY": "your_trello_api_key",
"TRELLO_TOKEN": "your_trello_token",
"LOG_PATH": "/path/to/log.txt",
"ENABLE_OBSIDIAN_TOOLS": "True/False",
"ENABLE_TRELLO_TOOLS": "True/False",
"ENABLE_CALENDAR_TOOLS": "True/False",
"ENABLE_NEWS_SEARCH": "True/False",
"ENABLE_WEB_PARSER": "True/False",
"SEMANTIC_SEARCH_ENABLED": "True/False",
"EMBEDDINGS_PATH": "/path/to/embeddings.json"
}
}
}
}
Замените пути и учетные данные на ваши фактические значения:
command: Путь к исполняемому файлу Python вашей виртуальной среды Pythonargs: Путь к файлуmain.pyвашего проектаENABLE_OBSIDIAN_TOOLS: установите значениеTrue, чтобы включить инструменты Obsidian.ENABLE_TRELLO_TOOLS: установите значениеTrue, чтобы включить инструменты Trello.ENABLE_CALENDAR_TOOLS: установите значениеTrue, чтобы включить инструменты Google Calendar.ENABLE_NEWS_SEARCH: установите значениеTrue, чтобы включить поиск новостей Google.ENABLE_WEB_PARSER: установите значениеTrue, чтобы включить инструмент веб-анализа.GOOGLE_CREDENTIALS_PATH: Путь к файлу учетных данных Google Календаря (credentials.json)GOOGLE_TOKEN_PATH: Путь к файлу токена Google Календаря (token.json)GOOGLE_API_KEY: Ваш ключ API Google (для API пользовательского поиска)GOOGLE_CX_ID: ваш идентификатор программируемой поисковой системы Google (CX ID для API пользовательского поиска)OBSIDIAN_VAULT_PATH: Путь к вашему хранилищу ObsidianOBSIDIAN_DEFAULT_FOLDER: Необязательный путь к папке по умолчанию в вашем хранилище, где будут создаваться новые заметки.TRELLO_API_KEY: Ваш ключ API TrelloTRELLO_TOKEN: Ваш токен API TrelloLOG_PATH: Путь к файлу журналаSEMANTIC_SEARCH_ENABLED: установите значениеTrue, чтобы включить семантический поиск для Obsidian Vault.SIMILARITY_TRESHOLD: Значение по умолчанию — 0,5, это порог для семантического поиска.EMBEDDINGS_PATH: Необязательный путь к файлу json для встраивания, созданному плагином Obsidian Vector Search (по умолчанию.obsidian/plugins/vector-search/data.jsonотносительноOBSIDIAN_VAULT_PATH, если не задано)MODEL_TOKEN_LIMIT: ограничение для модели ИИ, позволяющее ей понимать, когда следует разбивать заметки на частиCHUNK_SIZE_TOKENS: Размер фрагмента
Чтобы включить возможности семантического поиска, вам необходимо установить плагин Vector Search для Obsidian.
После завершения процесса переиндексации плагин сгенерирует JSON-файл, содержащий векторные вложения, в следующем месте:
.obsidian/plugins/vector-search/data.json
Этот файл будет использоваться в качестве источника встраивания для семантических поисковых запросов.
Рекомендованные клиенты:
Разработка
Проект использует Poetry для управления зависимостями.
Все инструменты зарегистрированы в
main.pyРеализации, специфичные для сервисов, находятся в каталоге
services/Следуйте рекомендациям по стилю PEP 8 для кода Python
Внося вклад
Форк репозитория
Создайте ветку функций (
git checkout -b feature/amazing-feature)Зафиксируйте свои изменения (
git commit -m 'Add some amazing feature')Отправить в ветку (
git push origin feature/amazing-feature)Открыть запрос на извлечение
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Единый интерфейс для управления цифровой жизнью посредством интеграции с Google Calendar, Obsidian Vault, Trello и возможностями анализа веб-страниц.
Related MCP Servers
- -securityAlicense-qualityIntegration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.Last updated -3MIT License