Нексус МКП

Функции

• Интеграция с Google Календарем

  • Создание, чтение, обновление и удаление событий календаря

  • Список предстоящих событий

• Управление хранилищем Obsidian

  • Создавайте, читайте, обновляйте и удаляйте заметки

  • Полнотекстовый поиск в заметках

  • Управление папками (создание, удаление, поиск, список)

• Интеграция с Трелло

  • Управление доской, списком и карточкой

  • Создание, обновление и удаление карт

  • Поиск карточек по текстовому запросу

• Анализ веб-страницы

  • Извлечение и очистка HTML-контента из любого URL-адреса

• Поиск новостей Google

  • Поиск последних новостных статей по заданной теме

Присоединяйтесь ко мне в Telegram и блоге

Related MCP server: VeyraX

Предпосылки

• Python 3.10 или выше

• Поэзия (менеджер пакетов Python)

• Учетные данные API Календаря Google

• Учетные данные API Trello (если используются функции Trello)

• Obsidian Vault (при использовании функций Obsidian)

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/yourusername/nexus-mcp.git
   cd nexus-mcp

2. Установка зависимостей с помощью Poetry:

   poetry install

3. Настройте API Календаря Google:

   • Перейдите в Google Cloud Console.

   • Создайте новый проект или выберите существующий

   • Включить API Календаря Google

   • Создать учетные данные OAuth 2.0

   • Загрузите учетные данные и сохраните их как credentials.json в корне проекта.

4. Настройте Trello API (необязательно):

   • Перейти на портал разработчиков Trello

   • Получите свой ключ API и токен

   • Добавьте их в переменные среды или файл конфигурации.

Конфигурация

1. Запустите первоначальную настройку для аутентификации в Google Calendar:

   poetry run python main.py

   • Откроется окно браузера для аутентификации Google.

   • Следуйте инструкциям для авторизации приложения.

Использование

1. Запустите сервер:

   poetry run python main.py

2. Сервер запустится и будет готов принимать клиентские подключения, совместимые с MCP.

3. Используйте любой 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 вашей виртуальной среды Python

• args : Путь к файлу 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 : Путь к вашему хранилищу Obsidian

• OBSIDIAN_DEFAULT_FOLDER : Необязательный путь к папке по умолчанию в вашем хранилище, где будут создаваться новые заметки.

• TRELLO_API_KEY : Ваш ключ API Trello

• TRELLO_TOKEN : Ваш токен API Trello

• LOG_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

Этот файл будет использоваться в качестве источника встраивания для семантических поисковых запросов.

Рекомендованные клиенты:

• Антропический Клод Рабочий стол

• 5ire

Разработка

• Проект использует Poetry для управления зависимостями.

• Все инструменты зарегистрированы в main.py

• Реализации, специфичные для сервисов, находятся в каталоге services/

• Следуйте рекомендациям по стилю PEP 8 для кода Python

Внося вклад

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение