A frontend application for the Model Context Protocol (MCP) Kit that enables enhanced interactions with Large Language Models through tool-based capabilities.

This repository is part of mcp-kit and serves as the user interface layer built with modern web technologies.

• Single Page Application architecture
• Real-time chat interface with LLMs
• Tool-based interaction capabilities
• Integration with MCP backend server
• Modern, responsive UI built with React and TypeScript

Experience MCP Kit in action - chat with LLMs while leveraging additional capabilities provided by the MCP server:

• Node.js 20.x
• NPM 7.x

1. Clone the repository:

git clone https://github.com/shaharia-lab/mcp-frontend.git
cd mcp-frontend

[Rest of standard installation steps...]

You can run MCP Frontend using our official Docker image:

docker pull ghcr.io/shaharia-lab/mcp-frontend:<version>

Replace <version> with the specific version you want to use (e.g., latest, 1.0.0).

docker run
-p 3000:3000
-e VITE_MCP_BACKEND_API_ENDPOINT=http://localhost:8081
ghcr.io/shaharia-lab/mcp-frontend:

The following environment variables are required to run MCP Frontend:

Simply copy the .env.example file to .env and update the values as needed to run the application locally. And for Docker, you can pass the environment variables using the -e flag.

Run the development server:

npm run dev

Build for production:

npm run build

For detailed configuration options, refer to the Vite documentation.

MCP Frontend is built with:

• Vite - Build tool and development server
• React - UI framework
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please ensure your PRs follow our coding standards and include appropriate tests.

• MCP-Kit Backend - The main backend server
• Documentation - Full project documentation

This project is under active development. While functional, it's not yet recommended for production use. We're working on:

• Enhanced error handling
• Improved performance
• Additional tool integrations
• Comprehensive testing suite

This project is licensed under the MIT License - see the LICENSE file for details.

• 📧 Email: hello@shaharialab.com
• 🐛 Issue Tracker
• 💬 Discord invite: Community Chat

• The MCP Kit community
• All our contributors and supporters