Mcp Local Spec

mcp-server-1.com

Welcome!

AI agents open great opportunities and enables so many new possibilities. Below is just one of the examples. so far the Agent Skills protocol look very promising, read about it here https://agentskills.io/home.

Follow me on X and LinkedIn to learn more about the ideas and cutting edge experiments.

https://jonnyzzz.com

https://www.linkedin.com/in/jonnyzzz

https://x.com/jonnyzzz

Discorevy local MCP Servers. Specification.

Version: 1.0.1

Goals

This specification aims to allow the standard way to list and configure MCP Servers on a local machine.

Many tools already use MCP Servers to augment the LLMs. Currently, there is no standard approach to quickly registering an MCP Server.

Here are the most popular MCP Clients:

• IntelliJ IDEA
• Anthropic Claude
• OpenAI ChatGPT
• Cursor
• Windsurf
• Warp
• PR to add you

Supported in the following tools

• PR if you support the spec

Specification

Create a file per each MCP server in the ~/.mcp folder (%USER_HOME% on Windows).

The file is a Markdown file that explains an LLM (such as Claude or CharGPT) about your MCP Server details. The client uses LLM to transform your explanation into an actionable MCP Server.

The client is required to regularly refresh the information from the disc to discover new MCP Servers.

This protocol does not resolve any security implications for MCP servers. That is still the responsibility of MCP Clients.

For example:

~/.mcp/my-mcp-server-tool-id.md

Create the following text inside:

---
version: 1.0.1
---

# MCP Server: Production

Here, I describe what my MCP Server is doing and why the LLM would decide to include my server in a specific request, which is queried.

## Basic Information
- **Name**: Production Jonnyzzz MCP Server
- **ID**: prod-mcp-01
- **Version**: 3.2.1
- **URL**: https://mcp-prod.jonnyzzz.com:8443
- **API Version**: v2

## Authentication
- **Type**: oauth2
- **Client ID**: client_123
- **Token Endpoint**: https://auth.example.com/token

## Capabilities
- compute
- storage
- networking

## Regions
### us-east
- us-east-1a
- us-east-1b

### eu-west
- eu-west-1a
- eu-west-1b

## Health Check
- **Endpoint**: /health
- **Interval**: 60 seconds

## Metadata
- **Environment**: production
- **Owner**: platform-team
- **Priority**: high

How to use the Spec?

An MCP client uses the LLM (e.g., Claude, ChatGPT) to extract the necessary information from each of the available MCP server's markdown files, which are discovered in the files under the ~/.mcp folder. It is up to the LLM and the client to decide if to use a specific LLM, ask for credentials, and so on. The client should refresh the files from the disk regularly.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jonnyzzz
• Source: jonnyzzz/mcp-local-spec
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.