Content
> ## ⚠️ Deprecated — no longer maintained
>
> This repository has been superseded. All new development and support lives in:
>
> - **[systempromptio/systemprompt-template](https://github.com/systempromptio/systemprompt-template)** — start here. Self-hosted evaluation of the full systemprompt.io AI governance infrastructure.
> - **[systempromptio/systemprompt-core](https://github.com/systempromptio/systemprompt-core)** — the underlying Rust library (MCP, A2A, OAuth 2.1, audit, compile-time extensions).
>
> Learn more at [systemprompt.io](https://systemprompt.io).
>
> _The original README is preserved below for historical reference._
---
# Systemprompt Multimodal MCP Client
<div align="center">
[](https://discord.com/invite/wkAbSuPWpr)
[](https://twitter.com/tyingshoelaces_)
[](https://www.linkedin.com/in/edjburton/)
[Website](https://systemprompt.io) • [Documentation](https://systemprompt.io/documentation) • [Blog](https://tyingshoelaces.com) • [Get API Key](https://systemprompt.io/console)
</div>
A modern voice-controlled AI interface powered by Google Gemini and Anthropic MCP (Model Control Protocol). Transform how you interact with AI through natural speech and multimodal inputs.
> **⚠️ Important Note**: This open source project is currently in development and in early access. It is not currently compatible with Safari but has been tested on Chrome with Linux, Windows, and MacOS. If you have any problems, please let us know on Discord or GitHub.
If you find this project useful, please consider:
- ⭐ Starring it on GitHub
- 🔄 Sharing it with others
- 💬 Joining our [Discord community](https://discord.com/invite/wkAbSuPWpr)
## 🌟 Overview
A modern Vite + TypeScript application that enables voice-controlled AI workflows through MCP (Model Control Protocol). This project revolutionizes how you interact with AI systems by combining Google Gemini's multimodal capabilities with MCP's extensible tooling system.
The Client supports both custom (user provided and configured) and Systemprompt MCP servers. Systemprompt MCP servers can be installed through the UX with a Systemprompt API key (free).
Custom MCP servers are not pre-configured and require a custom configuration file.
Create a local file `mcp.config.custom.json` in the `config` directory and add your MCP server configuration.
```json
{
"mcpServers": {
"my-custom-server": {
"id": "my-custom-server",
"env": {
"xxx": "xxx"
},
"command": "node",
"args": [
"/my-custom-server/build/index.js"
]
}
}
}
```
## 🎯 Why Systemprompt MCP?
Transform your AI interactions with a powerful voice-first interface that combines:
| Feature | Description |
| ----------------------------------- | ------------------------------------------------------------------------------- |
| 🗣️ **Multimodal AI** | Understand and process text, voice, and visual inputs naturally |
| 🛠️ **MCP (Model Control Protocol)** | Execute complex AI workflows with a robust tooling system |
| 🎙️ **Voice-First Design** | Control everything through natural speech, making AI interaction more intuitive |
**Perfect for**: Developers building voice-controlled AI applications and looking for innovative ways to use multimodal AI.
## ✨ Core Features
### 🎙️ Voice & Multimodal Intelligence
- **Natural Voice Control**: Speak naturally to control AI workflows and execute commands
- **Multimodal Understanding**: Process text, voice, and visual inputs simultaneously
- **Real-time Voice Synthesis**: Get instant audio responses from your AI interactions
### 🔄 AI Workflow Orchestration
- **Extensible Tool System**: Add custom tools and workflows through MCP
- **Workflow Automation**: Chain multiple AI operations with voice commands
- **State Management**: Robust handling of complex, multi-step AI interactions
### 💻 Developer Experience
- **Modern Tech Stack**: Built with Vite, React, TypeScript, and NextUI
- **Type Safety**: Full TypeScript support with comprehensive type definitions
- **Hot Module Replacement**: Fast development with instant feedback
- **Comprehensive Testing**: Built-in testing infrastructure with high coverage
## 🚀 Getting Started
### Prerequisites
- Node.js 16.x or higher
- npm 7.x or higher
- A modern browser with Web Speech API support
### Quick Start
1. **Clone the repository**
```bash
git clone https://github.com/Ejb503/multimodal-mcp-client.git
cd multimodal-mcp-client
```
2. **Install dependencies**
```bash
npm install
cd proxy
npm install
```
3. **Configure the application**
```bash
# Navigate to config directory
cd config
# Create local configuration files
cp mcp.config.example.json mcp.config.custom.json
```
Required API Keys:
- [Google AI Studio](https://ai.google.dev/gemini-api/docs) - Gemini API key
- [systemprompt.io/console](https://systemprompt.io/console) - Systemprompt API key
Add keys to `.env` (see `.env.example` for reference). note that the `VITE_` prefix is required to share the keys with the MCP server and client.
4. **Start development server**
```bash
npm run dev
```
Access the development server at `http://localhost:5173`
## 🤝 Support & Community
| Resource | Link |
| ---------- | ----------------------------------------------------------------------- |
| 💬 Discord | [Join our community](https://discord.com/invite/wkAbSuPWpr) |
| 🐛 Issues | [GitHub Issues](https://github.com/Ejb503/multimodal-mcp-client/issues) |
| 📚 Docs | [Documentation](https://systemprompt.io/documentation) |
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🔮 Future Development
We're actively working on expanding the capabilities of Systemprompt MCP Client with exciting new features and extensions. Stay tuned for updates!
