modelcontextprotocol/registry
Watch
1
0
Fork
You've already forked registry
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
registry/docs
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Andrew Cunliffe 718735cfbb
 docs(authentication): note OpenSSL 3.x requirement for Ed25519 (#1253) 
## Summary

The DNS and HTTP authentication guides currently run `openssl genpkey
-algorithm Ed25519 -out key.pem` without caveat. macOS ships LibreSSL as
the system `openssl` binary, and LibreSSL doesn't implement Ed25519 in
`genpkey` — so the very first command in the Ed25519 codepath errors out
with:

```
Algorithm Ed25519 not found
```

A first-time integrator on macOS hits this immediately, with no path to
a fix from the docs alone. Cost me ~5 minutes earlier today before I
figured out I needed `brew install openssl@3` and an explicit binary
path.

This PR adds a `<Note>` callout to the **DNS Authentication** section
right above the Ed25519 codepath, and a shorter cross-reference Note in
the **HTTP Authentication** section since the same `openssl genpkey
-algorithm Ed25519` commands appear there. The ECDSA P-384 codepath
works on LibreSSL, so it's untouched.

## Test plan

- [x] Verified locally that `/opt/homebrew/opt/openssl@3/bin/openssl
genpkey -algorithm Ed25519 -out key.pem` works on macOS Darwin 25.4.0
- [x] Verified the system `/usr/bin/openssl genpkey -algorithm Ed25519
-out key.pem` fails with `Algorithm Ed25519 not found` on the same
machine (LibreSSL 3.3.6)
- [x] Verified the published `ai.ravenmcp/raven-mcp` flow end-to-end
with the OpenSSL 3 binary
- [ ] Markdown rendering of the `<Note>` callouts — relying on the
existing `<Note>` pattern in this file (line 6) to validate the syntax

Co-authored-by: Radoslav Dimitrov <radoslav@stacklok.com>
2026-05-07 10:42:37 -04:00
..
administration Add registry maintainer onboarding documentation (#820) 2025-12-08 13:43:37 +00:00
contributing update schema url point to the actual location (#884) 2026-02-10 13:32:58 -08:00
design update schema url point to the actual location (#884) 2026-02-10 13:32:58 -08:00
modelcontextprotocol-io docs(authentication): note OpenSSL 3.x requirement for Ed25519 (#1253) 2026-05-07 10:42:37 -04:00
reference docs: document GitHub OIDC audience binding for self-hosters and CI users (#1230) 2026-04-29 20:56:53 -04:00
community-projects.md docs: add ToolHive Registry Server to community projects (#1261) 2026-05-07 10:36:03 -04:00
README.md docs: fix broken links in Documentation Index (#822) 2025-12-08 13:43:16 +00:00

README.md

MCP Registry Documentation

The MCP registry provides MCP clients with a list of MCP servers, like an app store for MCP servers.

I want to...

Documentation Index