MCP Assistant

1<div align="center">
2  <img src="./public/logo.svg" alt="MCP Assistant Logo" width="96" height="96" />
3  <h1>MCP Assistant</h1>
4  <img src="./public/images/mcpassistant.png" alt="MCP Assistant Banner" width="100%" />
5  <p><strong>Web-based MCP client for remote servers and AI tool workflows.</strong></p>
6 
7  [![Website](https://img.shields.io/badge/Website-mcp--assistant.in-0A66C2?style=for-the-badge&logo=googlechrome&logoColor=white)](https://www.mcp-assistant.in/)
8  [![Docs](https://img.shields.io/badge/Docs-mcp--ts-111827?style=for-the-badge&logo=readthedocs&logoColor=white)](https://zonlabs.github.io/mcp-ts/)
9  [![License](https://img.shields.io/badge/License-MIT-16A34A?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](LICENSE)
10</div>
11 
12## 🌐 Overview
13 
14MCP Assistant addresses common pain points when working with the Model Context Protocol:
15 
16## ✨ Why MCP Assistant
17 
18- Connect to remote MCP servers from one interface
19- Manage multiple MCP servers from a single interface
20- Handle OAuth 2.0 and OpenID Connect flows without manual token juggling
21- Explore available tools and run them directly from the UI
22- Monitor connections in real time while testing and debugging integrations
23- Work from anywhere without local MCP server setup
24 
25## 🚀 Core Capabilities
26 
27- Connect and manage MCP servers from a single workspace
28- Discover available tools and execute them from the UI
29- Use the local gateway to expose machine-local MCP tools through one endpoint
30- Use the same endpoint from any MCP-compatible client (for example: ChatGPT, Claude, and others)
31- Enable selected local gateway servers for Playground agent tool execution
32- Handle OAuth/OIDC auth flows for protected MCP servers
33- Browse registry servers and test integrations before production use
34 
35## 🏗️ Architecture
36 
37### Local Gateway for ChatGPT, Claude, and Other MCP Clients
38 
39<img src="./public/images/mcpassistant-gateway.png" alt="MCP Assistant Gateway Banner" width="100%" />
40 
41MCP Assistant includes a local gateway that exposes your configured MCP servers through one local endpoint, so desktop/web clients can connect without reconfiguring each remote server.
42 
43### ⚡ Gateway Quickstart
44 
451. Install and run the gateway:
46```bash
47uvx mcpassistant-gateway
48```
492. Log in from the gateway CLI using `/login`.
503. Start the bridge using `/start`.
514. Open the Gateway page in MCP Assistant and copy your generated MCP URL.
525. Use that URL in your MCP client (for example: ChatGPT, Claude, or the MCP Assistant Playground).
53 
54```mermaid
55flowchart TD
56    subgraph Browser["Browser"]
57        B[User Browser]
58    end
59 
60    subgraph MCPA["MCP Assistant"]
61        subgraph UI["UI"]
62            direction TB
63            MAR["MCP Assistant Registry"]
64            MPR["Model Context Protocol Registry"]
65            PG["Playground"]
66        end
67 
68        subgraph Backend["Backend"]
69            LA["LangGraph Agent"]
70            DB[("Database")]
71        end
72    end
73 
74    subgraph External["External APIs"]
75        MCP_IO["modelcontextprotocol.io"]
76    end
77 
78    subgraph ToolsResources["Tools / Resources"]
79        C7["Context7"]
80        DW["DeepWiki"]
81    end
82 
83    B -- "HTTPS" --> UI
84    MAR -- "GraphQL" --> DB
85    PG -- "Execute" --> LA
86    MPR -- "HTTPS" --> MCP_IO
87    PG -- "AG-UI state (URL, transport, auth token, etc.)" --> LA
88    UI -- "MCP protocol" --> ToolsResources
89    LA -- "MCP protocol" --> ToolsResources
90```
91 
92## ⚡ Quick Start
93 
94### ➕ Add an MCP Server
95 
961. Open the MCP Servers page.
972. Click `Add Server`.
983. Enter:
99   - `Server Name`
100   - `Server URL`
101   - Optional OAuth2 configuration
1024. Save to connect.
103 
104### 🔧 Enable Local MCP Access for Playground
105 
1061. Open `Settings` -> `Connectors`.
1072. In `Local MCP Access For Playground`, click `Refresh` to detect local gateway servers.
1083. Check the servers you want the Playground agent to use.
1094. Open Playground and ask for a task that requires those tools.
110 
111 
112## 🤝 Contributing
113 
114Contributions are welcome.  
115Please open an issue for major changes or submit a pull request directly for improvements and fixes.
116