Dead link for py key value

[strawgate]

Description

https://gofastmcp.com/servers/storage-backends#storage-backends

Has a dead link as it's linking to py-key-value-aio on GitHub but the repo is actually just py-key-value

Example Code

Version Information

Latest

[marvin-context-protocol]

Claude finished @strawgate's task —— View job

---

Investigation Complete

Issue Type: Documentation Bug - Broken External Link

---

Recommendation

Update two dead links in docs/servers/storage-backends.mdx (lines 145 and 256) from https://github.com/strawgate/py-key-value-aio to https://github.com/strawgate/py-key-value.

The repository py-key-value-aio does not exist as a standalone repository. Instead, strawgate/py-key-value is a monorepo containing both the py-key-value-aio (async) and py-key-value-sync (sync) packages.

---

Findings

Broken Links Identified

The documentation file docs/servers/storage-backends.mdx contains three references to the py-key-value library:

Line	Link Text	URL	Status
16	py-key-value-aio	https://github.com/strawgate/py-key-value	✅ Correct
145	py-key-value-aio documentation	https://github.com/strawgate/py-key-value-aio	❌ Dead link
256	py-key-value-aio GitHub	https://github.com/strawgate/py-key-value-aio	❌ Dead link

Root Cause: The py-key-value-aio package is published to PyPI but lives in the strawgate/py-key-value monorepo on GitHub, not in a separate py-key-value-aio repository.

Repository Structure Verification

From the strawgate/py-key-value repository structure:

py-key-value/
├── key-value/
│   ├── key-value-aio/     # Async package (supported)
│   └── key-value-sync/    # Sync package (generated from async)
└── README.md

The monorepo contains:

• py-key-value-aio: Async key-value store library (primary/supported package)
• py-key-value-sync: Sync key-value store library (under development, generated from async API)

Dependency Confirmation: pyproject.toml:19 shows FastMCP depends on py-key-value-aio[disk,memory]>=0.2.6,<0.3.0

---

Detailed Action Plan

A junior developer can fix this by following these steps:

1. Open the documentation file:

   # Navigate to the file
   open docs/servers/storage-backends.mdx

2. Update line 145:

   • Find: [py-key-value-aio documentation](https://github.com/strawgate/py-key-value-aio)
   • Replace with: [py-key-value-aio documentation](https://github.com/strawgate/py-key-value)

3. Update line 256:

   • Find: [py-key-value-aio GitHub](https://github.com/strawgate/py-key-value-aio)
   • Replace with: [py-key-value-aio GitHub](https://github.com/strawgate/py-key-value)

4. Verify the change:

   # Check that all links now point to the correct repository
   grep -n "strawgate/py-key-value" docs/servers/storage-backends.mdx

   All three occurrences should now point to strawgate/py-key-value (not -aio)

5. Test locally (optional):

   • Visit https://github.com/strawgate/py-key-value to confirm it exists
   • Verify the monorepo contains documentation for py-key-value-aio

6. Run required checks:

   uv sync                              # Install dependencies
   uv run pre-commit run --all-files    # Ruff + Prettier + ty
   uv run pytest                        # Run full test suite

7. Commit and push:

   git add docs/servers/storage-backends.mdx
   git commit -m "Fix dead links to py-key-value repository"
   git push

---

Related Items

Related Issues and Pull Requests

Repository	Item	Relevance
jlowin/fastmcp	#2168: Loosen Version Constraint for redis Package	Mentions py-key-value-aio dependency and references the library
jlowin/fastmcp	#2072: Secret storage	Contains the same broken link in a comment (line pointing to docs)
jlowin/fastmcp	#1845: Add Response Caching Middleware	Original PR that introduced py-key-value-aio to FastMCP
jlowin/fastmcp	#1913: Add Storage to FastMCP	PR that switched OAuth to use py-key-value library
jlowin/fastmcp	#2196: Bump py-key-value-aio to 0.2.6	Recent dependency update

Related Files

Repository	File	Relevance	Sections
jlowin/fastmcp	docs/servers/storage-backends.mdx	Contains the broken links that need fixing	16, 145, 256
jlowin/fastmcp	pyproject.toml	Shows the py-key-value-aio dependency specification	19
strawgate/py-key-value	README.md	Main documentation for the monorepo containing py-key-value-aio	Root README
strawgate/py-key-value	DEVELOPING.md	Explains the monorepo structure with async and sync packages	Full file

---

[strawgate]

/marvin get it done

[marvin-context-protocol]

Claude finished @strawgate's task —— View job • claude/issue-2216-20251022-2311 • Create PR ➔

---

Fixing Dead Links to py-key-value Repository

Tasks

• Read documentation file to verify current state
• Update line 145: Fix link to py-key-value-aio documentation
• Update line 256: Fix link to py-key-value-aio GitHub
• Run development workflow checks (uv sync, pre-commit, pytest)
• Commit and push changes
• Provide PR creation link

Summary

Fixed two dead links in docs/servers/storage-backends.mdx that were pointing to the non-existent strawgate/py-key-value-aio repository. Both links now correctly point to strawgate/py-key-value, which is the monorepo containing the py-key-value-aio package.

Changes:

• Line 145: Updated documentation link
• Line 256: Updated GitHub repository link

All checks passed (pre-commit hooks and full test suite).

---

View job | Branch: claude/issue-2216-20251022-2311