Skip to main content
Glama
deenesjakoruzh

Personal Assistant MCP Server

by lemannrus
GitHub
Python
3
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Нексус МКП

Функции

  • Интеграция с Google Календарем
    • Создание, чтение, обновление и удаление событий календаря
    • Список предстоящих событий
  • Управление хранилищем Obsidian
    • Создавайте, читайте, обновляйте и удаляйте заметки
    • Полнотекстовый поиск в заметках
    • Управление папками (создание, удаление, поиск, список)
  • Интеграция с Трелло
    • Управление доской, списком и карточкой
    • Создание, обновление и удаление карт
    • Поиск карточек по текстовому запросу
  • Анализ веб-страницы
    • Извлечение и очистка HTML-контента из любого URL-адреса
  • Поиск новостей Google
    • Поиск последних новостных статей по заданной теме

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

Предпосылки

  • 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 (необязательно):

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

  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.

img.png

После завершения процесса переиндексации плагин сгенерирует JSON-файл, содержащий векторные вложения, в следующем месте:

.obsidian/plugins/vector-search/data.json

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

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

Разработка

  • Проект использует 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. Открыть запрос на извлечение

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Единый интерфейс для управления цифровой жизнью посредством интеграции с Google Calendar, Obsidian Vault, Trello и возможностями анализа веб-страниц.

  1. Функции
    1. Предпосылки
      1. Установка
        1. Конфигурация
          1. Использование
            1. Конфигурация рабочего стола Anthropic Claude
              1. Рекомендованные клиенты:
                1. Разработка
                  1. Внося вклад

                    Related MCP Servers

                    • Google Tasks MCP Server

                      zcaceres
                      -
                      security
                      A
                      license
                      -
                      quality
                      Integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.
                      Last updated -
                      72
                      TypeScript
                      MIT License

                    • Calendar Tools MCP Server

                      cablate
                      -
                      security
                      A
                      license
                      -
                      quality
                      Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
                      Last updated -
                      9
                      2
                      TypeScript
                      MIT License

                    • VeyraXofficial

                      VeyraX
                      A
                      security
                      F
                      license
                      A
                      quality
                      Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
                      Last updated -
                      3
                      40
                      TypeScript

                    • MCP G Suite Integration

                      alBERT-launcher
                      -
                      security
                      A
                      license
                      -
                      quality
                      Integration 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 -
                      3
                      Python
                      MIT License
                      • Apple

                    View all related MCP servers

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/lemannrus/personal-assistant-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server