Skip to content

A lightweight, browser-based MCP (Model Context Protocol) client for connecting to and interacting with remote MCP-compatible servers.

License

Notifications You must be signed in to change notification settings

ashen-dusk/mcp-assistant

Repository files navigation

MCP Assistant Logo

MCP Assistant

A Web Based MCP Client to access remote MCP's

Website Next.js TypeScript License

🎯 Purpose

MCP Assistant addresses common pain points developers face when working with the Model Context Protocol:

  • Remote MCP Access: Enables seamless connection to remote MCP servers via SSE and Streamable HTTP transports
  • OAuth Complexity: Handles complex OAuth 2.0 authorization flows automatically, eliminating the need for manual token management
  • Multi-Server Management: Manage and interact with multiple MCP servers simultaneously without juggling between different CLI tools or configurations
  • No Local Setup Required: Access MCP servers from anywhere through a web interface - no need to install or configure MCP servers locally
  • Universal Compatibility: Works with any MCP server that supports SSE or HTTP streaming, providing a unified interface regardless of the underlying implementation
  • Developer-Friendly: Built-in tools explorer, real-time connection monitoring, and intuitive UI make MCP development easier

Whether you're building MCP integrations, testing MCP servers, or simply exploring the MCP ecosystem, MCP Assistant streamlines the entire workflow.

🌟 Features

MCP Protocol Agent–User Interaction (AG-UI Protocol)
• Supported transport via SSE and Streamable HTTP
• Configure and manage multiple servers simultaneously
• OAuth 2.0 Authorization Server Metadata (RFC8414) and OpenID Connect Discovery 1.0 support
• Real-time connection status monitoring
• Tool execution
Stream text message events - Real-time message streaming for responsive interactions
Backend tool rendering - Visualize tool outputs in chats
Tool output streaming - Stream tool results and logs as real-time events
Interrupts (human in the loop) - Pause and approve workflows without losing state
Shared state - Context-aware responses using MCP tools

Getting Started with MCP Assistant

🔌 Adding an MCP Server

  1. Navigate to the MCP servers page.
  2. Click the "Add Server" button.
  3. Fill in the server details:
    • Server Name: A friendly name for your server.
    • Transport Type: Choose between SSE or Streamable HTTP.
    • Server URL: The endpoint of your MCP server.
    • OAuth2 Configuration (Optional): If your server requires authentication.
  4. Click "Save" to establish the connection.

💬 Using the Chat Interface

  1. Select one or more connected MCP servers from the sidebar.
  2. Choose your preferred LLM provider.
  3. Enter your API key securely.
  4. Start Chatting: The assistant is now ready to use tools from your connected MCP servers!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

A lightweight, browser-based MCP (Model Context Protocol) client for connecting to and interacting with remote MCP-compatible servers.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6