MCPを用いたAIアシスタントです。

実行前にインストールする方法

##基本セットアップ

• [uv]:
• インストールuvはこちら
• 実行 uv sync
• レガシー
• python venv と [pip install -r requirements.txt を作成します。

このアプリケーションは、アーケードを使用してツールの使用を容易にするため、ローカルMCPサーバーを実行したり、クラウド内でリモートに接続したりする必要はありません。 アーケードにサインアップし、このリポジトリを使用するために登録した時点で無料のAPIキーを入手してください。

プロジェクトのルートの .env ファイルに次の環境変数を設定します。

※1LLMキーのみが必要です。 このリポジトリは、現在OpenAIとAnthropicモデルのみをサポートしています。

デフォルトでは、エージェントは使用許可されていないツールのアーケードでOAuthフローをキックオフします。 これにより、その流れが完了するまで停止するexectuion を引き起こします。 OAuth を蹴らずに無許可のツールをスキップしてブロックしないなら、[SKIP_CLI_AUTH=true] を設定します。

保守性とトレース

このプロジェクトでは、Langfuse を使用して、保守性とトレースを行います。 その必須ではありませんが、UIでフォーマットされた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