The Open-Source Gateway to Local & Cloud Intelligence
RunAshChat is a high-performance AI chat interface powered by Model Context Protocol (MCP), built with Next.js and the Vercel AI SDK.
Live Demo • Features • MCP Setup • Quick Start
- Streaming & Versatile: Real-time text streaming using the Vercel AI SDK, supporting multiple LLM providers.
- MCP First: Deep integration with Model Context Protocol (MCP) to give your AI access to local files, databases, or APIs.
- Dual-Transport Support: Connect to remote tool providers via HTTP or SSE (Server-Sent Events).
- Reasoning-Ready: Full support for "Chain of Thought" models (like DeepSeek-R1 or O1) with UI-optimized thinking blocks.
- Modern UI/UX: A sleek, responsive interface built with shadcn/ui and Tailwind CSS.
- Edge Optimized: Leverages the Next.js App Router for maximum performance.
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| AI Integration | Vercel AI SDK |
| Protocol | Model Context Protocol (MCP) |
| Styling | Tailwind CSS + Lucide Icons |
| Components | shadcn/ui |
git clone https://github.com/your-username/runashchat.git
cd runashchat
npm install
Create a .env.local file in the root directory:
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
# Add other providers as needed
npm run dev
Open http://localhost:3000 to see the result.
RunAshChat allows you to dynamically extend the AI's capabilities by adding MCP servers directly through the UI.
- Open Settings: Click the ⚙️ icon next to the model selector.
- Server Details: Enter a friendly name for the server.
- Transport Type: * HTTP: Best for stateless remote toolkits.
- SSE: Recommended for long-lived connections and streaming tool responses.
- Connect: Enter the endpoint URL and click Add Server.
Tip
Popular MCP Servers to try:
- Composio (Tools & Integrations)
- Zapier Central (Workflow Automation)
- Hugging Face (Model Discovery)
This project is licensed under the Apache License 2.0. See the LICENSE file for more details.
Built with ❤️ by the RunAsh community.
- Visual Elements: Added a placeholder for a logo and used badges/tables to make the "Tech Stack" easier to scan.
- Admonitions: Used GitHub's "Tip" syntax to highlight MCP server examples.
- Quick Start: Added the essential terminal commands that developers look for immediately.
- Modern Branding: Updated the tagline to be more punchy and descriptive.
Would you like me to help you draft a CONTRIBUTING.md file or generate a specific LICENSE file for this project?