Это помощник ИИ, который работает с использованием MCP.

Как установить перед запуском

Базовая настройка

• [[Т0]]:
• установить uv проверить здесь
• бег [[Т2]] наследие
• создать python venv и [Т3].

Это приложение использует Arcade для облегчения использования инструментов, поэтому вам не нужно запускать какие-либо локальные серверы MCP или подключаться к любому удаленно в облаке. Пожалуйста, зарегистрируйтесь в Arcade и получите бесплатный ключ api здесь после регистрации для использования этого репо.

Установите следующие переменные окружения в файле .env в корне проекта:

Вам нужен только один LLM-ключ. Репо поддерживает только модели OpenAI и Anthropic.

По умолчанию агент начнет поток OAuth с Arcade для любых инструментов, которые он не уполномочен использовать. Это приведет к тому, что экскурсия остановится, пока этот поток не завершится. Если вы хотите пропустить какие-либо несанкционированные инструменты, не запуская OAuth, чтобы он не блокировал, установите SKIP_CLI_AUTH=true.

Наблюдение и отслеживание

Этот проект использует Langfuse для наблюдения и отслеживания. Это не обязательно, но полезно видеть десятки звонков LLM, которые хорошо отформатированы в пользовательском интерфейсе. Чтобы использовать его, установите эти переменные среды в .env:

Как бегать

MCP Agent

This is an AI assistant that runs using MCP.

How to install before running

Basic Setup

• uv:
  • install uv check here
  • run uv sync
• legacy
  • create a python venv and pip install -r requirements.txt.

This application uses Arcade to facilitate tool use so you don’t need to run any local MCP servers or connect to any remotely in the cloud. Please sign up for Arcade and get a free api key here once registered to use this repo.

Set the following enviroment variables in an .env file in the project root:

ANTHROPIC_API_KEY=
ARCADE_API_KEY=
OPENAI_API_KEY=

You only need ONE LLM key. This repo only supports OpenAI and Anthropic models currently.

By default the agent will kick off an OAuth flow with Arcade for any tools that its not authorized to use. This will cause the exectuion to pause until that flow completes. If you want to skip any unauthorized tools without kicking off OAuth so that it doesn’t block, set SKIP_CLI_AUTH=true.

Observability and tracing

This project uses Langfuse for observability and tracing. Its not mandatory but its helpful to see the dozens of LLM calls that occur nicely formatted in a UI. To utilize it, set these environment variables in the .env:

LANGFUSE_SECRET_KEY=
LANGFUSE_PUBLIC_KEY=
LANGFUSE_HOST="https://cloud.langfuse.com"

How to Run

The MCP Assistant application is heavily customizable. You can do anything email triaging to lead qualification.

The default workflow generates a daily briefing over various tools like email, calendar, whatsapp and Notion that tells you your schedule for the day, gives you background research from the internet about who you’re meeting with and tells you what is urgent.

Run the Default Flow - Daily Briefing in Notion

1. Create a Notion page called Daily Briefings. Ideally this should be at the root of your Notion workspace.
2. Update the user_context in main in main.py with a description of who you are, how you like to work (like what communication tools you prefer) and any extra information that will make the model’s output better. Update the base_system_prompt with any special instructions you want it to take into account.
3. The instructions for the LLM on how to generate the daily briefing are in the INPUT_ACTION variable in main.py in the main method. Change the step-by-step instructions based on how you want you daily briefing created.
   For example, if you want the briefing to also check a specific Notion page that has your tasks, the model can also do this
4. (Optional) You can alter the DEFAULT_TOOLS array at the top of plan_exec_agent .py to have only these values ["Gmail", "Google Calendar", "Whatsapp", "Exa", "Notion"] so you don’t have to set up every MCP server