What is Mcpfoundation

MCP Foundation is a Model Context Protocol Manager designed to manage MCP servers efficiently through both a web interface and command line tools. It simplifies the process of adding, removing, and viewing MCP servers.

Use cases

MCP Foundation can be used for easily managing different versions and instances of MCP servers. It’s useful for developers who need to switch between environments or configurations rapidly or want a streamlined way to work with various MCPS.

How to use

MCP Foundation can be used via a web interface with the command npx -p mcpfoundation web, or through CLI commands such as npx mcpfoundation add <name> to add a server, npx mcpfoundation rm <name> to remove one, and npx mcpfoundation ls to list all installed servers.

Key features

Key features include one-click installation on Pinokio, easy addition and removal of MCP servers through simple CLI commands, web UI for ease of access, and support for customization of server paths and configurations.

Where to use

MCP Foundation is suitable for local development environments, CI/CD pipelines, or any scenario where managing multiple MCP servers is necessary, making it ideal for developers and teams working on diverse projects.

MCP Foundation

Model Context Protocol Manager

1. Web

npx -y -p mcpfoundation@latest web

2. CLI

npx mcpfoundation add <name> (<args...>)
npx mcpfoundation rm <name> (<args...>)
npx mcpfoundation ls

1. Easily add or remove MCP servers with one line.
2. View published servers.

Quickstart

1. One-Click Install

Install Pinokio and run MCP Foundation in Pinokio. Everything is taken care of.

2. Manual Install

1. Follow the instructions in the Install Section to install the prerequisites.
2. Run npx mcpfoundation add cocktailpeanut/mcp/sqlite

Install

1. One-Click Install

Install on Pinokio.

2. Manual Install

First make sure the following prerequisites are installed on your machine.

1. UV: https://docs.astral.sh/uv/
2. Git: https://git-scm.com/
3. Sqlite3: https://www.servermania.com/kb/articles/install-sqlite
4. Node.js: https://nodejs.org/en

Web Usage

The easiest way to use is through the web ui.

npx -p mcpfoundation web

CLI Usage

1. add

Basic

npx mcpfoundation add <name>

Modules that require environment variables:

npx mcpfoundation add <github id>/<name> --GITHUB_PERSONAL_ACCESS_TOKEN <token> ...

2. rm

npx mcpfoundation rm <name>

3. update

npx mcpfoundation update

4. ls

display all installed mcp servers

npx mcpfoundation ls

Customize

Web UI Customization

Environment variables

1. PORT: (for web ui only) use custom port for the web ui
2. MCP_DEFAULT_REPO: (for web ui only) the default mcp default repository

Additionally, any environment variables on your system will be available

MCP Client Customization

By default, the MCP config file is stored under the Claude app

• Windows: %AppData%/Claude/claude_desktop_config.json
• Mac: $HOME/Library/Application Support/Claude/claude_desktop_config.json

But you can change these locations by setting:

• MCP_CONFIG_PATH: the absolute path where the config file needs to be stored.

MCP Server Path Customization

By default, all the MCP Foundation code is downloaded under ~/mcpfoundation.

You can change this behavior by setting:

• MCP_SERVER_PATH: the absolute path where each MCP foundation repository will be downloaded.

Environment Value Customization

By default, MCP clients use the system wide environment variables. But sometimes you may want to make it use custom environment variables. In these cases you can use:

• MCP_ENV: a comma separated value to specify the environment variable names to inherit

• Example: If you set MCP_OVERRIDE_ENV=PATH, the PATH value of the current environment will be used by the MCP client.

• When is this useful?:

  • Sometimes you want to run these commands inside a specific context such as conda environment or venv. If you do not override the MCP environment, it will just use the default PATH to run the programs globally.