Cleric

🚀 Cleric

Cleric is a desktop application that helps you manage the Model Context Protocol (MCP) servers for Claude Desktop. It offers an intuitive interface for you to add, remove, and configure your MCP servers.

Builds for MacOS and Windows can be found at the following link: GitHub Releases

⚠️ Important Note

Version 0.3.0 has been released for Windows but has not been tested on Windows yet. Any feedback is welcome. Special attention is needed for the code related to starting and stopping the MCP monitor.

✨ Features

• Seamlessly switch between MCP servers in Claude Desktop.
• Automatically save changes: Any changes you make are saved in real-time.
• Synchronize with Claude Desktop: Any servers you manually add to Claude Desktop will be automatically synchronized.
• Clearly distinguish between connected and disconnected servers.

🚀 Quick Start

Interface Layout

• The main window is divided into two parts: the server list on the left and the detailed information view on the right.
• There are two buttons at the top of the list: Add and Remove.

Operation Guide

• Click the Add button to open a dialog box. Enter the server address (e.g., wss://api.claude.ai/v1beta/) and click Connect.
• After a successful connection, the server status in the list will show as connected, and its detailed information will be displayed.
• Click the Remove button to remove the selected server from the list.

📚 Documentation

Project Background

This project is developed using the Fyne toolkit. It features a simple interface design and intuitive functionality.

Change Log

Version: 0.5.0 - Release Date: 2025-01-25
Updates:
- Removed the function to start the MCP monitor.
- Fixed the issue of the window not centering properly.
- Updated the project icon.
- Optimized the interface layout.

Version: 0.4.0 - Release Date: 2025-01-20
New Features:
- Added buttons for maximizing and minimizing the window.
- Added an about dialog.
- Supported dark mode.
- Updated the project badges.

Version: 0.3.0 - Release Date: 2025-01-15
New Features:
- First release for Windows.
- Added real-time updates for server connection status.
- Added the function to center the window.

Project Structure

.
├── cmd/
│   └── cleric/          # Application entry point
├── internal/
│   └── ui/             # Interface components and logic
│   └── config/         # Code for managing the MCP server list
└── build/              # Build output directory

How to Contribute

1. Fork this repository on GitHub.
2. Create a feature branch (e.g., feature/amazing-feature).
3. Commit your changes (e.g., git commit -m 'Add amazing feature').
4. Push to the branch (e.g., git push origin feature/amazing-feature).
5. Submit a Pull Request.

📄 License

This project is licensed under the terms of the LICENSE file located in the root directory.

Version Information

The application version information is embedded during the build from cmd/cleric/version.txt.

Reference Documents

• Fyne Official Documentation
• Fyne Sample Source Code

Acknowledgments

This project is my first attempt at learning the Fyne toolkit. Special thanks to Alex Ballas's go2tv project for its inspiration and reference. His well-structured code clearly demonstrates the power of Fyne.