LLM/MCP Personal Assistant

LLM/MCP Personal Assistant

A personal assistant application built using the Model Context Protocol (MCP) that enables sophisticated interactions between AI models and external tools/resources. Currently uses the Anthropic API and supports Wikipedia search and GitHub search, but is easily extendable.

Overview

This application is a personal assistant that leverages the Model Context Protocol to provide enhanced AI capabilities. It consists of three main components:

1. Client: A React-based web interface that provides the user interface for interacting with the assistant
2. API Server: An Express.js backend that handles client requests and manages the communication between components
3. MCP Server: Implements the Model Context Protocol to facilitate communication between AI models and external tools/resources

Features

• Modern React-based web interface
• RESTful API for handling client requests
• MCP server implementation for AI model integration
• Support for sophisticated AI interactions and tool usage
• Current tool support:
  • Wikipedia search
  • GitHub search
• Extendable architecture for adding new tools and capabilities

Note: This is a work in progress. While currently supporting Wikipedia and GitHub search capabilities, the architecture is designed to be easily extended with additional tools and features.

Prerequisites

• Node.js (v14 or higher)
• pnpm package manager (v10.9.0 or higher)

Installation

1. Clone this repository:

git clone https://github.com/mikefey/LLM-MCP-personal-assistant.git
cd LLM-MCP-personal-assistant

2. Install dependencies:

pnpm install

3. Create a .env file in the root directory with the following variables:

ANTHROPIC_API_KEY=your_anthropic_api_key_here
VITE_API_PORT=3001
VITE_API_HOST=localhost

Replace your_anthropic_api_key_here with your actual Anthropic API key. The default port and host values can be adjusted if needed.

Usage

1. Start the development server:

pnpm dev

This command will:

• Build the MCP server
• Start the API server
• Launch the Vite development server for the client

Architecture

Client

The client is a React application built with Vite that provides the user interface for interacting with the personal assistant.

API Server

The API server is built with Express.js and handles:

• Client requests
• Communication with the MCP server
• Session management
• Data persistence

MCP Server

The MCP server implements the Model Context Protocol specification, enabling:

• Communication with AI models
• Tool integration
• Context management
• Resource access

License

This project is licensed under the ISC License.

Acknowledgments

• Based on the Model Context Protocol specification
• Inspired by the tutorials from modelcontextprotocol.info