port-keeper MCP server

port-keeper is a small helper that hands out port numbers to your projects. If you run several copies of the same project at once, each copy normally fights over the same ports. This tool gives every copy its own set, and your AI can ask it which address a service is on.

What this MCP server does

You ask your AI something like which address the admin screen of a project is on. Your AI calls this helper. The helper checks its local record and finds the port for that service. It hands the address back, and your AI tells you the answer. It can also write the port numbers into your project's .env file when you ask it to set up a copy.

Click to zoom

What you can do with it

• Look up the web address of a service by name
• Give a new copy of a project its own block of ports
• Write the port numbers into your .env file
• Check which project and copy you are currently in
• See whether your .env file is out of date
• Reuse another copy's database and mail catcher for a new copy
• Find out what is using a port that is already taken

Try asking your AI

• “What is the address of the admin screen for shop slot 3?”
• “Set up a new copy of this project for the hotfix branch and give it its own ports.”
• “Is my .env file up to date for this working copy?”
• “Which project and slot am I in right now?”

What it gives back to you

You get back plain answers in the chat, like a web address such as http://localhost:20000 or a short note saying which project and copy you are in. When you ask it to set up ports, it writes them into a file in your project and tells you it is done. It can also report whether your .env file is out of date.

Before you start

Who it's for

Developers who run several copies of the same project at once, or who use coding agents in parallel and keep hitting port clashes.