What is Vibestation

Vibestation is an AI and MCP client for desktop, enabling users to chat with AI models and utilize MCP tools effectively.

Use cases

Use cases for Vibestation include developing AI-driven applications, conducting experiments with different AI models, and creating interactive learning tools.

How to use

To use Vibestation, clone the repository, install dependencies, configure your API keys in a .env file, and start the development server using npm commands.

Key features

Key features include chatting with AI models (Claude, OpenAI), loading and using MCP servers and tools, saving and loading chat history, and displaying HTML artifacts in a sandbox environment.

Where to use

Vibestation can be used in various fields such as software development, AI research, and educational environments where interaction with AI models is beneficial.

Vibestation

Vibestation is an AI and MCP client for desktop, similar to Claude Desktop. It allows you to chat with AI models and use MCP tools.

Features

• Chat with AI models (Claude, OpenAI)
• Load and use MCP servers and tools
• Save and load chat history
• Display HTML artifacts in a sandbox environment

Technology Stack

• Electron: Desktop application framework
• React: UI library
• TypeScript: Programming language
• Tailwind CSS: Styling
• AI SDK: AI model integration
• MCP Client: MCP server integration

Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm (v7 or higher)

Installation

1. Clone the repository:

git clone https://github.com/yourusername/vibestation.git
cd vibestation

2. Install dependencies:

npm install

3. Create a .env file in the root directory with your API keys:

ANTHROPIC_API_KEY=your_anthropic_api_key_here
OPENAI_API_KEY=your_openai_api_key_here

Development

Start the development server:

npm start

Building

Build the application for production:

npm run make

This will create platform-specific installers in the out directory.

Configuration

AI Providers

Configure AI providers in config/ai.config.json:

MCP Servers

Configure MCP servers in config/mcp.config.json:

{
  "servers": [
    {
      "name": "local-tools",
      "type": "stdio",
      "command": "node ./mcp-servers/local-tools/index.js",
      "enabled": true,
      "autoStart": true
    },
    {
      "name": "remote-server",
      "type": "sse",
      "url": "https://example.com/sse",
      "apiKey": "${API_KEY_ENV_VAR}",
      "enabled": true,
      "autoStart": false
    }
  ],
  "defaultServer": "local-tools"
}

Project Structure

vibestation/
├── config/                 # Configuration files
├── src/                    # Source code
│   ├── main/               # Electron main process
│   ├── preload/            # Preload scripts
│   ├── renderer/           # React UI
│   ├── components/         # React components
│   ├── contexts/           # React contexts
│   ├── services/           # Core services
│   └── utils/              # Utility functions
├── assets/                 # Application assets
└── scripts/                # Build and utility scripts

License

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