Skip to content

Commit 3171c1a

Browse files
niechenniechen
committed
Update project description
1 parent e9a9b86 commit 3171c1a

File tree

8 files changed

+145
-104
lines changed

8 files changed

+145
-104
lines changed

‎README.md‎

Lines changed: 25 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# MCP - Model Context Protocol Package Manager
1+
# MCP Manager - Model Context Protocol Management Tool
22

3-
MCP is a Homebrew-like service and command-line interface for managing Model Context Protocol (MCP) servers across various MCP clients.
3+
MCP Manager is a Homebrew-like service and command-line interface for managing Model Context Protocol (MCP) servers across various MCP clients.
44

55
## Overview
66

7-
MCP aims to simplify the installation, configuration, and management of Model Context Protocol servers with a focus on:
7+
MCP Manager aims to simplify the installation, configuration, and management of Model Context Protocol servers with a focus on:
88

99
- Easy installation of MCP servers via a simple CLI
1010
- Centralized management of server configurations across multiple clients
@@ -22,77 +22,59 @@ MCP will support managing MCP servers for the following clients:
2222

2323
## Command Line Interface (CLI)
2424

25-
MCP provides a comprehensive CLI built with Python's Click framework. Below are the available commands:
25+
MCP Manager provides a comprehensive CLI built with Python's Click framework. Below are the available commands:
2626

2727
### Basic Commands
2828

2929
```
3030
mcp --help # Display help information and available commands
31-
mcp --version # Display the current version of MCP
31+
mcp --version # Display the current version of MCP
3232
```
3333

34-
### Search Commands
34+
### Available Commands
3535

3636
```
37-
mcp search [QUERY] # Search available MCP servers
38-
mcp search --tags=TAG # Search servers by tag
39-
```
40-
41-
### Installation Commands
37+
mcp client # Manage the active MCP client
38+
mcp client set CLIENT_NAME # Set the active MCP client
39+
mcp client list # List available MCP clients and their status
4240
43-
```
44-
mcp install SERVER_NAME # Install an MCP server
45-
mcp install SERVER_NAME --version=VERSION # Install specific version
46-
mcp remove SERVER_NAME # Remove an installed MCP server
47-
mcp update [SERVER_NAME] # Update installed servers (or specific server)
48-
```
41+
mcp edit # View or edit the active MCP client's configuration file
4942
50-
### List Commands
43+
mcp list # List all installed MCP servers
5144
52-
```
53-
mcp list # List all installed MCP servers
54-
mcp list --available # List all available MCP servers
55-
mcp list --outdated # List installed servers with updates available
56-
```
45+
mcp remove SERVER_NAME # Remove an installed MCP server
5746
58-
### Configuration Commands
47+
mcp server # Manage MCP server processes
48+
mcp server start SERVER_NAME # Start an MCP server
49+
mcp server stop SERVER_NAME # Stop an MCP server
50+
mcp server restart SERVER_NAME # Restart an MCP server
51+
mcp server status # Show status of running MCP servers
5952
60-
```
61-
mcp config SERVER_NAME # Configure an installed MCP server
62-
mcp config --edit SERVER_NAME # Open server config in default editor
63-
mcp config --reset SERVER_NAME # Reset server config to defaults
53+
mcp toggle SERVER_NAME # Toggle an MCP server on or off for a client
6454
```
6555

66-
### Status Commands
67-
68-
```
69-
mcp status [SERVER_NAME] # Show status of all or specific MCP servers
70-
mcp status --client=CLIENT_NAME # Show status of MCP servers for a specific client
71-
mcp enable SERVER_NAME --client=CLIENT_NAME # Enable an MCP server for a specific client
72-
mcp disable SERVER_NAME --client=CLIENT_NAME # Disable an MCP server for a specific client
73-
```
56+
### Coming Soon Commands
7457

75-
### Server Management
58+
The following commands are planned for future releases:
7659

7760
```
78-
mcp server start SERVER_NAME # Start an MCP server
79-
mcp server stop SERVER_NAME # Stop an MCP server
80-
mcp server restart SERVER_NAME # Restart an MCP server
81-
mcp server log SERVER_NAME # View server logs
61+
mcp install SERVER_NAME # Install an MCP server
62+
mcp search [QUERY] # Search available MCP servers
63+
mcp status # Show status of MCP servers in Claude Desktop
8264
```
8365

8466
## Roadmap
8567

8668
- [x] Landing page setup
87-
- [ ] CLI foundation
69+
- [x] CLI foundation
8870
- [ ] Server repository structure
8971
- [ ] Claude Desktop client integration
9072
- [ ] Server management functionality
9173
- [ ] Additional client support
9274

9375
## Development
9476

95-
This repository contains the CLI and service components for MCP, built with Python and Click following modern package development practices.
77+
This repository contains the CLI and service components for MCP Manager, built with Python and Click following modern package development practices.
9678

9779
### Development Requirements
9880

‎bump_version.sh‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ if [ $# -ne 1 ]; then
99
fi
1010

1111
NEW_VERSION=$1
12-
VERSION_FILE="version.py"
12+
VERSION_FILE="src/mcp/version.py"
1313

1414
# Update the version file
1515
echo '"""Single source of truth for MCP version."""

‎pages/index.html‎

Lines changed: 47 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6-
<title>MCP - Model Context Protocol | getmcp.sh</title>
6+
<title>MCP Manager - Model Context Protocol | getmcp.sh</title>
77
<link rel="preconnect" href="https://fonts.googleapis.com">
88
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
99
<link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;600&family=Inter:wght@300;400;600;700&display=swap" rel="stylesheet">
@@ -13,11 +13,11 @@
1313
--bg-accent: #1a1d25;
1414
--text-primary: #e2e8f0;
1515
--text-secondary: #a0aec0;
16-
--accent-color: #7c3aed;
17-
--accent-light: #8b5cf6;
18-
--accent-dark: #6d28d9;
19-
--success: #10b981;
20-
--code-bg: #1e1e2e;
16+
--accent-color: #10b981;
17+
--accent-light: #34d399;
18+
--accent-dark: #047857;
19+
--success: #059669;
20+
--code-bg: #1a2e22;
2121
--card-border: #2d3748;
2222
}
2323

@@ -33,8 +33,8 @@
3333
color: var(--text-primary);
3434
background-color: var(--bg-color);
3535
background-image:
36-
radial-gradient(circle at 25% 25%, rgba(124, 58, 237, 0.05) 0%, transparent 50%),
37-
radial-gradient(circle at 75% 75%, rgba(124, 58, 237, 0.05) 0%, transparent 50%);
36+
radial-gradient(circle at 25% 25%, rgba(16, 185, 129, 0.05) 0%, transparent 50%),
37+
radial-gradient(circle at 75% 75%, rgba(16, 185, 129, 0.05) 0%, transparent 50%);
3838
margin: 0;
3939
padding: 0;
4040
min-height: 100vh;
@@ -49,7 +49,7 @@
4949
header {
5050
text-align: center;
5151
padding: 3rem 0;
52-
border-bottom: 1px solid rgba(124, 58, 237, 0.2);
52+
border-bottom: 1px solid rgba(16, 185, 129, 0.2);
5353
margin-bottom: 3rem;
5454
}
5555

@@ -174,7 +174,7 @@
174174
font-size: 0.9rem;
175175
text-align: center;
176176
padding: 2rem 0;
177-
border-top: 1px solid rgba(124, 58, 237, 0.1);
177+
border-top: 1px solid rgba(16, 185, 129, 0.1);
178178
}
179179

180180
a {
@@ -212,54 +212,72 @@
212212
<div class="container">
213213
<header>
214214
<h1>MCP</h1>
215-
<div class="tagline">The Model Context Protocol Manager</div>
215+
<div class="tagline">Model Context Protocol Management Tool</div>
216216
</header>
217217

218218
<div class="coming-soon">
219219
<h2>🚀 Quick Installation</h2>
220220
<p>Install MCP with a single command:</p>
221221
<code><span class="command-prompt">$</span> curl -sSL https://getmcp.sh/install | bash</code>
222-
<p>MCP is a Homebrew-like service for managing Model Context Protocol (MCP) configs and servers.</p>
222+
<p>MCP Manager is a Homebrew-like service for managing Model Context Protocol (MCP) servers across clients.</p>
223223
</div>
224224

225225
<h2>What to Expect</h2>
226+
<h2>Available Features</h2>
226227
<div class="features">
227228
<div class="feature">
228-
<h3><span>🧩</span> Simple Config Installation</h3>
229-
<p>Install Model Context Protocol configs with a single command:</p>
230-
<code><span class="command-prompt">$</span> mcp install claude-config</code>
229+
<h3><span>👥</span> Client Management</h3>
230+
<p>Easily switch between and manage MCP clients:</p>
231+
<code><span class="command-prompt">$</span> mcp client set claude-desktop</code>
231232
</div>
232233

233234
<div class="feature">
234-
<h3><span>🔄</span> Easy Updates</h3>
235-
<p>Keep your MCP configs up to date effortlessly:</p>
236-
<code><span class="command-prompt">$</span> mcp update</code>
235+
<h3><span>📋</span> Server Listing</h3>
236+
<p>View all your installed MCP servers:</p>
237+
<code><span class="command-prompt">$</span> mcp list</code>
237238
</div>
238239

239240
<div class="feature">
240-
<h3><span>🔍</span> Config Discovery</h3>
241-
<p>Find available Model Context Protocol configs:</p>
242-
<code><span class="command-prompt">$</span> mcp search</code>
241+
<h3><span>⚙️</span> Server Management</h3>
242+
<p>Control your MCP server processes with ease:</p>
243+
<code><span class="command-prompt">$</span> mcp server start my-server</code>
243244
</div>
244245

245246
<div class="feature">
246-
<h3><span>⚙️</span> Server Management</h3>
247-
<p>Streamlined configuration and management for Model Context Protocol servers:</p>
248-
<code><span class="command-prompt">$</span> mcp server config</code>
247+
<h3><span>🔀</span> Server Toggling</h3>
248+
<p>Enable or disable servers for specific clients:</p>
249+
<code><span class="command-prompt">$</span> mcp toggle my-server</code>
250+
</div>
251+
</div>
252+
253+
<h2>Coming Soon</h2>
254+
<div class="features">
255+
<div class="feature">
256+
<h3><span>🧩</span> Simple Server Installation</h3>
257+
<p>Install MCP servers with a single command:</p>
258+
<code><span class="command-prompt">$</span> mcp install claude-config</code>
259+
</div>
260+
261+
<div class="feature">
262+
<h3><span>🔍</span> Server Discovery</h3>
263+
<p>Find available Model Context Protocol servers:</p>
264+
<code><span class="command-prompt">$</span> mcp search</code>
249265
</div>
250266
</div>
251267

252268
<div class="clients">
253-
<h2>Supported Configs</h2>
254-
<p>Our initial release will include config support for:</p>
269+
<h2>Supported Clients</h2>
270+
<p>MCP currently supports these AI clients:</p>
255271
<ul>
256-
<li><strong>Claude Desktop</strong> - Configs for Anthropic's Model Context Protocol client</li>
257-
<li><em>More Model Context Protocol configs coming soon...</em></li>
272+
<li><strong>Claude Desktop</strong> - Anthropic's AI assistant</li>
273+
<li><strong>Windsurf</strong> - The world's first agentic IDE</li>
274+
<li><strong>Cursor</strong> - AI-enhanced code editor</li>
275+
<li><em>More clients coming soon...</em></li>
258276
</ul>
259277
</div>
260278

261279
<footer>
262-
<p>© 2025 MCP Project | <a href="https://github.com/pathintegral-xyz/getmcp.sh">GitHub</a></p>
280+
<p>© 2025 MCP Manager | <a href="https://github.com/pathintegral-xyz/getmcp.sh">GitHub</a></p>
263281
</footer>
264282
</div>
265283
</body>

‎pages/install‎

Lines changed: 61 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,16 @@ set -e
66
RED='\033[0;31m'
77
GREEN='\033[0;32m'
88
YELLOW='\033[0;33m'
9-
BLUE='\033[0;34m'
10-
PURPLE='\033[0;35m'
9+
DARK_GREEN='\033[0;32m'
10+
LIGHT_GREEN='\033[1;32m'
1111
CYAN='\033[0;36m'
1212
NC='\033[0m' # No Color
1313

14-
echo -e "${BLUE}┌─────────────────────────────────────────────┐${NC}"
15-
echo -e "${BLUE}│ │${NC}"
16-
echo -e "${BLUE}│ ${GREEN}MCP - Model Context Protocol Package Manager${BLUE} │${NC}"
17-
echo -e "${BLUE}│ │${NC}"
18-
echo -e "${BLUE}└─────────────────────────────────────────────┘${NC}"
14+
echo -e "${DARK_GREEN}┌─────────────────────────────────────────────┐${NC}"
15+
echo -e "${DARK_GREEN}│ │${NC}"
16+
echo -e "${DARK_GREEN}│ ${LIGHT_GREEN}MCP - Model Context Protocol Manager${DARK_GREEN} │${NC}"
17+
echo -e "${DARK_GREEN}│ │${NC}"
18+
echo -e "${DARK_GREEN}└─────────────────────────────────────────────┘${NC}"
1919
echo
2020

2121
# Function to check if a command exists
@@ -25,7 +25,7 @@ command_exists() {
2525

2626
# Function to print info message
2727
info() {
28-
echo -e "${CYAN}INFO:${NC} $1"
28+
echo -e "${DARK_GREEN}INFO:${NC} $1"
2929
}
3030

3131
# Function to print error message
@@ -35,7 +35,7 @@ error() {
3535

3636
# Function to print success message
3737
success() {
38-
echo -e "${GREEN}SUCCESS:${NC} $1"
38+
echo -e "${LIGHT_GREEN}SUCCESS:${NC} $1"
3939
}
4040

4141
# Function to check Python version
@@ -79,18 +79,57 @@ ensure_pip() {
7979
install_mcp() {
8080
info "Installing MCP..."
8181

82-
if command_exists pipx; then
83-
info "Using pipx to install MCP (recommended)..."
84-
pipx install mcp
82+
# Check if we're on macOS
83+
if [[ "$(uname)" == "Darwin" ]]; then
84+
# macOS installation path
85+
if command_exists pipx; then
86+
info "Using pipx to install MCP (recommended)..."
87+
pipx install mcp
88+
elif command_exists brew; then
89+
info "pipx not found, installing it via Homebrew..."
90+
brew install pipx
91+
info "Now installing MCP with pipx..."
92+
pipx install mcp
93+
else
94+
info "Creating a dedicated virtual environment for MCP..."
95+
MCP_VENV="$HOME/.mcp-venv"
96+
python3 -m venv "$MCP_VENV"
97+
"$MCP_VENV/bin/pip" install mcp
98+
99+
# Create symlinks to the user's bin directory
100+
USER_BIN="$HOME/.local/bin"
101+
mkdir -p "$USER_BIN"
102+
ln -sf "$MCP_VENV/bin/mcp" "$USER_BIN/mcp"
103+
104+
info "Installed MCP in a virtual environment at $MCP_VENV"
105+
info "Added symlink to $USER_BIN/mcp"
106+
107+
# Add PATH warning if needed
108+
if ! echo "$PATH" | grep -q "$USER_BIN"; then
109+
echo "Warning: $USER_BIN is not in your PATH"
110+
echo "Add the following to your shell profile (~/.bashrc, ~/.zshrc, etc.):"
111+
echo " export PATH=\"$USER_BIN:\$PATH\""
112+
fi
113+
fi
85114
else
86-
# Try to use pip in user mode first
87-
python3 -m pip install --user mcp || {
88-
info "Attempting system-wide installation with sudo..."
89-
sudo python3 -m pip install mcp || {
115+
# Non-macOS installation path - try standard methods
116+
if command_exists pipx; then
117+
info "Using pipx to install MCP (recommended)..."
118+
pipx install mcp
119+
else
120+
# Try to use pip in user mode with appropriate flags
121+
info "Installing with pip in user mode..."
122+
python3 -m pip install --user mcp || {
90123
error "Failed to install MCP. Please check your permissions and try again."
124+
echo "You may want to try one of these alternatives:"
125+
echo " 1. Install pipx (https://pypa.github.io/pipx/) and run: pipx install mcp"
126+
echo " 2. Create a virtual environment and install there:"
127+
echo " python3 -m venv ~/.mcp-venv"
128+
echo " source ~/.mcp-venv/bin/activate"
129+
echo " pip install mcp"
91130
exit 1
92131
}
93-
}
132+
fi
94133
fi
95134
}
96135

@@ -100,12 +139,12 @@ verify_installation() {
100139
MCP_VERSION=$(mcp --version 2>/dev/null || echo "Unknown")
101140
success "MCP $MCP_VERSION has been successfully installed!"
102141
echo
103-
echo -e "${PURPLE}To get started with MCP, try:${NC}"
104-
echo -e " ${CYAN}mcp --help${NC} # Show available commands"
105-
echo -e " ${CYAN}mcp list --available${NC} # List available MCP servers"
106-
echo -e " ${CYAN}mcp install <server>${NC} # Install an MCP server"
142+
echo -e "${DARK_GREEN}To get started with MCP, try:${NC}"
143+
echo -e " ${LIGHT_GREEN}mcp --help${NC} # Show available commands"
144+
echo -e " ${LIGHT_GREEN}mcp list --available${NC} # List available MCP servers"
145+
echo -e " ${LIGHT_GREEN}mcp install <server>${NC} # Install an MCP server"
107146
echo
108-
echo -e "For more information, visit ${BLUE}https://getmcp.sh${NC}"
147+
echo -e "For more information, visit ${DARK_GREEN}https://getmcp.sh${NC}"
109148
echo
110149
else
111150
PATH_DIRS=$(echo $PATH | tr ':' '\n')

0 commit comments

Comments
 (0)