Skip to content

Commit 39478da

Browse files
authored
Merge pull request modelcontextprotocol#455 from modelcontextprotocol/pcarleton/spec-proposal-guidelines
[docs] Add guidelines for specification proposals
2 parents 78bdd7b + 2ed380f commit 39478da

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

CONTRIBUTING.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,24 @@ When contributing to the documentation:
7070
- Follow existing file naming conventions (kebab-case.mdx)
7171
- Include proper frontmatter in MDX files
7272

73+
### Specification Proposal Guidelines
74+
75+
#### Principles of MCP
76+
77+
1. **Simple + Minimal**: It is much easier to add things to a specification than it is to
78+
remove them. To maintain simplicity, we keep a high bar for adding new concepts and
79+
primitives as each addition requires maintenance and compatibility consideration.
80+
2. **Concrete**: Specification changes need to be based on specific implementation
81+
challenges and not on speculative ideas.
82+
83+
### Stages of a specification proposal
84+
85+
1. **Define**: Explore the problem space, validate that other MCP users face a similar
86+
issue, and then clearly define the problem.
87+
2. **Prototype**: Build an example solution to the problem and demonstrate its practical
88+
application.
89+
3. **Write**: Based on the prototype, write a specification proposal.
90+
7391
## Submitting Changes
7492

7593
1. Push your changes to your fork

0 commit comments

Comments
 (0)