Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/michaellatman/mcp-get


https://github.com/michaellatman/mcp-get

Last synced: 2 months ago
JSON representation

Awesome Lists containing this project

README 

          
# mcp-get



A powerful command-line tool for discovering, installing, and managing Model Context Protocol (MCP) servers. This tool simplifies the process of connecting Large Language Models (LLMs) to external data sources, tools, and services.



With mcp-get, you can:

- Discover available MCP servers from our curated registry

- Install servers with a single command

- Manage environment variables and configurations

- Update and uninstall servers as needed



## Quick Start



Try mcp-get immediately:



```bash

npx @michaellatman/mcp-get@latest list

npx @michaellatman/mcp-get@latest install @modelcontextprotocol/server-brave-search

```



All packages added to the registry are automatically displayed on [mcp-get.com](https://mcp-get.com), making them discoverable to other users.



## About Model Context Protocol



The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.



Learn more about MCP at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction)



## What Packages Can You Install?



This tool helps you install and manage MCP servers that connect Claude to various data sources and tools, including:



- **Development Tools**: GitHub, GitLab

- **Communication Tools**: Slack

- **Search & Data**: Brave Search, Google Maps

- **Database Systems**: PostgreSQL, SQLite

- **Web Automation**: Puppeteer

- **Cloud Storage**: Google Drive



## Prerequisites



- Node.js (version 14 or higher) for Node.js-based MCP servers

- Python (version 3.10 or higher) for Python-based MCP servers

- Go (version 1.16 or higher) for Go-based MCP servers

- Claude Desktop app (for local MCP server usage)



## Usage Examples



### Install a Package



```

npx @michaellatman/mcp-get@latest install @modelcontextprotocol/server-brave-search

```



Sample output:

```

Installing @modelcontextprotocol/server-brave-search...

Installation complete.

```



#### Install a Specific Version



You can also install a specific version of a package:



```

npx @michaellatman/mcp-get@latest install @modelcontextprotocol/server-brave-search 1.0.0

```



Sample output:

```

Installing @modelcontextprotocol/server-brave-search version 1.0.0...

Installation complete.

```



The version syntax follows standard package manager conventions:

- For Node.js packages: `package@version` (e.g., `@modelcontextprotocol/server-brave-search@1.0.0`)

- For Python packages: `package==version` (e.g., `mcp-server-aidd==0.1.19`)

- For Go packages: `package@version` (e.g., `example.com/go-server@v1.0.0`)



### List Packages



```

npx @michaellatman/mcp-get@latest list

```



Sample output:

```

📦 Available Packages

Found 11 packages



@modelcontextprotocol/server-brave-search │ MCP server for Brave Search API integration │ Anthropic, PBC (https://anthropic.com) │ MIT

@modelcontextprotocol/server-everything   │ MCP server that exercises all the features of the MCP protocol │ Anthropic, PBC (https://anthropic.com) │ MIT

...

```



### Uninstall a Package



```

npx @michaellatman/mcp-get@latest uninstall @modelcontextprotocol/server-brave-search

```



Sample output:

```

Uninstalling @modelcontextprotocol/server-brave-search...

Uninstallation complete.

```



### Update the Tool



The tool automatically checks for updates when running commands. You can also manually update:



```

npx @michaellatman/mcp-get@latest update

```



Sample output:

```

Updating mcp-get...

Update complete.

```



## Contributing



We welcome contributions to the project! If you would like to contribute, please follow these guidelines:



1. Fork the repository and create a new branch for your feature or bugfix.

2. Write tests for your changes and ensure all existing tests pass.

3. Submit a pull request with a clear description of your changes.



## License



This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.



## Contact Information



If you have any questions or need help, feel free to reach out:



- GitHub Issues: [michaellatman/mcp-get](https://github.com/michaellatman/mcp-get/issues)



## Adding Your Own MCP Server to the Registry



There are two ways to add your MCP server to the registry:



### Option 1: Manual Package Addition



If you want to maintain your own package:



1. **Create Your MCP Server**: 

   - Develop your MCP server according to the [MCP protocol specifications](https://modelcontextprotocol.io)

   - Publish it as either an NPM package (installable via npm) or a Python package (installable via uvx)



2. **Add Your Package to the Package Folder**: Add your server as a JSON file in the `packages/` directory:



   - For regular packages, use `packages/your-package-name.json`

   - For scoped packages, use `packages/scope--package-name.json` (double hyphens between scope and name)



   ```json

   {

     "name": "your-package-name",

     "description": "A brief description of your MCP server",

     "vendor": "Your Name or Organization",

     "sourceUrl": "URL to the source code repository",

     "homepage": "URL to the homepage or documentation",

     "license": "License type (e.g., MIT)",

     "runtime": "node | python | go",

     "environmentVariables": {

       "SOME_API_KEY": {

         "description": "Description of what this key is for",

         "required": true

       }

     }

   }

   ```



   Important notes:

   - The `name` field must be the exact resolvable package name in npm or pip

   - The `runtime` field specifies how your package should be installed:

     - Use `"runtime": "node"` for packages that should be installed via npm

     - Use `"runtime": "python"` for packages that should be installed via uvx

   - Always include an `environmentVariables` object (can be empty `{}` if none required)



3. **Validate Your Package**: Run the PR check to validate your package:

   ```

   npm run pr-check

   ```



4. **Submit a Pull Request**: Fork this repository, add your package file, and submit a PR.



### Option 2: Community Servers Repository



If you don't want to manage package deployment and distribution:



1. **Fork Community Repository**: 

   - Fork [mcp-get/community-servers](https://github.com/mcp-get/community-servers)

   - This repository follows the same structure as the official MCP servers



2. **Add Your Server**:

   - Add your implementation to the `src` directory

   - Follow the existing patterns and structure

   - Include necessary documentation and tests



3. **Submit a Pull Request**:

   - Submit your PR to the community servers repository

   - Once merged, your server will be automatically added to the registry



Both options require following the [MCP protocol specifications](https://modelcontextprotocol.io). Choose the option that best fits your needs:

- Option 1 if you want full control over your package distribution

- Option 2 if you want to avoid managing package deployment and distribution