Skip to content

Commit a53a11d

Browse files
committed
docs: warn about archived reference servers (modelcontextprotocol#4785)
Clarify archived packages are unmaintained; update SECURITY.md and examples.
1 parent d73f99e commit a53a11d

1 file changed

Lines changed: 8 additions & 10 deletions

File tree

‎README.md‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,9 @@ These servers aim to demonstrate MCP features and the official SDKs.
3838

3939
The following reference servers are now archived and can be found at [servers-archived](https://github.com/modelcontextprotocol/servers-archived).
4040

41+
> [!WARNING]
42+
> Archived servers are **unmaintained** and provide **no security guarantees**. Their npm packages may still install, but they are not supported by this repository. Prefer actively maintained servers from the [MCP Registry](https://registry.modelcontextprotocol.io/) (or the replacements noted below when available). See [SECURITY.md](SECURITY.md) for reporting guidance.
43+
4144
- **[AWS KB Retrieval](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/aws-kb-retrieval-server)** - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
4245
- **[Brave Search](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/brave-search)** - Web and local search using Brave's Search API. Has been replaced by the [official server](https://github.com/brave/brave-search-mcp-server) ([`@brave/brave-search-mcp-server`](https://www.npmjs.com/package/@brave/brave-search-mcp-server)).
4346
- **[EverArt](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/everart)** - AI image generation using various models.
@@ -116,23 +119,18 @@ Additional examples of using the Claude Desktop as an MCP client might look like
116119
"command": "uvx",
117120
"args": ["mcp-server-git", "--repository", "path/to/git/repo"]
118121
},
119-
"github": {
120-
"command": "npx",
121-
"args": ["-y", "@modelcontextprotocol/server-github"],
122-
"env": {
123-
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
124-
}
125-
},
126-
"postgres": {
127-
"command": "npx",
128-
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
122+
"time": {
123+
"command": "uvx",
124+
"args": ["mcp-server-time"]
129125
}
130126
}
131127
}
132128
```
133129

134130
On Windows, apply the same wrapper to each `npx`-based entry above by changing `"command"` to `"cmd"` and prepending `"/c", "npx"` to the existing `args`. Leave `uvx` entries unchanged.
135131

132+
Do not configure archived packages such as `@modelcontextprotocol/server-github` or `@modelcontextprotocol/server-postgres` from new setups — see [Archived](#archived).
133+
136134
## 🛠️ Creating Your Own Server
137135

138136
Interested in creating your own MCP server? Visit the official documentation at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction) for comprehensive guides, best practices, and technical details on implementing MCP servers.

0 commit comments

Comments
 (0)