이것은 MCP를 사용하여 실행되는 AI 조수입니다.

실행하기 전에 설치하는 방법

기본 설정

• uv:
• uv을 설치
• 실행 uv sync
• 유산
• python venv 및 pip install -r requirements.txt를 만듭니다.

이 응용 프로그램은 아케이드를 사용하여 도구를 사용하므로 로컬 MCP 서버를 실행하거나 클라우드에서 원격으로 연결할 필요가 없습니다. 아케이드에 가입하고 이 재포를 사용하기 위해 등록 한 무료 api 키를 얻으십시오.

프로젝트 루트의 .env] 파일에 다음과 같은 환경 변수를 설정:

하나 LLM 키 **만 필요 합니다. 이 repo는 현재 OpenAI 및 Anthropic 모델을 지원합니다.

기본적으로 에이전트가 사용 허가되지 않은 모든 도구에 대한 아케이드와 OAuth 흐름을 킥한다. 이것은 그 흐름이 완료 될 때까지 일시 중지에 대한 실행을 일으킬 것입니다. OAuth를 킥하지 않고 무단 도구를 건너 뛰고 싶다면, SKIP_CLI_AUTH=true를 설정하십시오.

Observability 및 추적

이 프로젝트는 관찰성 및 추적에 대한 Langfuse를 사용합니다. 그것의 필수 하지만 그것의 도움이 될 것 이다 수십 LLM 호출의 UI에 잘 포맷. 그것을 활용하려면, 이 환경 변수를 .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