Skip to main content
Glama
deenesjakoruzh

Personal Assistant MCP Server

by lemannrus
GitHub
Python
2
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 Calendar

                      GongRzhe
                      -
                      security
                      F
                      license
                      -
                      quality
                      Google Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                      Last updated -
                      5
                      0
                      5
                      JavaScript

                    • Calendar AutoAuth MCP Server

                      GongRzhe
                      -
                      security
                      A
                      license
                      -
                      quality
                      Server for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                      Last updated -
                      22
                      6
                      JavaScript
                      MIT License

                    • Webflow MCP Server

                      kapilduraphe
                      A
                      security
                      A
                      license
                      A
                      quality
                      Enables Claude to interact with Webflow's APIs for managing sites, retrieving information, and executing tasks using natural language.
                      Last updated -
                      2
                      4
                      TypeScript
                      MIT License
                      • Apple
                      • Linux

                    • Google Calendar MCP Server

                      takumi0706
                      -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.
                      Last updated -
                      133
                      21
                      TypeScript
                      MIT License

                    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