A mcp client chat application built for learning purposes
概览
A desktop application for interacting with AI models via the Model Context Protocol (MCP), providing a powerful interface for chat conversations with tool execution capabilities. The Model Context Protocol (MCP) is a standardized communication protocol that enables AI models to request execution of tools and functions with user confirmation. This creates a secure and transparent environment for AI assistants to interact with your system while maintaining user control. - 🤖 : Connect to Claude, GPT, and other LLMs through a unified interface - 🔧 : Allow AI models to perform actions through a secure permission system - 🔄 : Experience fluid conversations with streaming responses - 🔌 : Register, configure and connect to MCP servers - 💾 : Save and revisit your chat sessions - 🔐 : Store sensitive information like API keys safely MCP Client demonstrates how to create applications that leverage the full potential of modern AI systems while maintaining appropriate security boundaries.
README
以下为原文 README 节选，完整内容请查看原文。
MCP Client Application
A desktop application for interacting with AI models via the Model Context Protocol (MCP), providing a powerful interface for chat conversations with tool execution capabilities.
What is MCP?
The Model Context Protocol (MCP) is a standardized communication protocol that enables AI models to request execution of tools and functions with user confirmation. This creates a secure and transparent environment for AI assistants to interact with your system while maintaining user control.
Features
- 🤖 Multi-model support: Connect to Claude, GPT, and other LLMs through a unified interface
- 🔧 Tool execution: Allow AI models to perform actions through a secure permission system
- 🔄 Real-time streaming: Experience fluid conversations with streaming responses
- 🔌 Server management: Register, configure and connect to MCP servers
- 💾 Conversation history: Save and revisit your chat sessions
- 🔐 Secure vault: Store sensitive information like API keys safely
Why Use MCP Client?
MCP Client demonstrates how to create applications that leverage the full potential of modern AI systems while maintaining appropriate security boundaries. It serves as both a practical tool and a learning resource for developers interested in building applications with AI capabilities.
Getting Started
Prerequisites
- Node.js 18+
- npm package manager
Installation
# Clone the repository
git clone [email protected]:RegiByte/mcp-client-app.git
cd mcp-client-app
# Install dependencies
npm install
# Start the development server
npm dev
Building for Production
# For Windows
npm build:win
# For macOS
npm build:mac
# For Linux
npm build:linux
Using the Application
Starting a Conversation
- Open the application
- Navigate to the conversations page
- Click on “New conversation”
- Start chatting!
Working with Tools
When an AI assistant needs to perform an action:
- You’ll see a tool execution request in the chat
- Review the requested action and parameters
- Approve or deny the request
- See the results integrated back into the conversation
Architecture Overview
The MCP Client App is built with:
- Electron: For cross-platform desktop capabilities
- React: For the user interface
- TypeScript: For type-safe code
- Vercel AI SDK: For standardized AI model interactions
- Model Context Protocol: For secure and standardized tool execution
The application uses a driver pattern to support multiple LLM providers while maintaining a consistent interface.
Learning Resources
- MCP Protocol Documentation
- Vercel AI SDK Guide
- Building MCP-enabled Applications
- Tool Development Guide
Contributing
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →