cyanheads/model-context-protocol-resources
Exploring the Model Context Protocol (MCP) through practical guides, clients, and servers I've built while learning about this new protocol.
291 ★30 forksUpdated 1y ago
What you need to know
A collection of Model Context Protocol guides, utilities, templates, and example server implementations created by the author while learning MCP — including MCP Server and Client Development Guides, an MCP TypeScript template, the mcp-reporter utility, and 12 example server implementations.
Install
Not a runnable server — clone the repo or follow per-project setup in each linked server repository (e.g. cyanheads/mcp-ts-template has its own install)
Usage
- •Read the MCP Server Development Guide (transports, tools/resources/prompts, security, updated for Auth Spec 2025-03-26) and MCP Client Development Guide
- •Use the mcp-ts-template as a production-ready starting point for building MCP servers and clients
- •Pick an example server (atlas, git, github, obsidian, pubmed, etc.) and follow its repository's setup instructions
- •Connect any MCP-compatible client (e.g. Claude Desktop, Cline) or build your own using the Client Development Guide
Key features
- ✓Comprehensive MCP guides: Server Development (Stdio + Streamable HTTP, TypeScript SDK, security best practices) and Client Development
- ✓mcp-ts-template — beginner-friendly, production-ready template for MCP servers and clients with utilities and type safety
- ✓mcp-reporter utility that generates capability reports for MCP servers
- ✓12 example server implementations: atlas-mcp-server, clinicaltrialsgov, filesystem, git, github, mentor (Deepseek 'second opinion'), ntfy, obsidian, perplexity, pubmed, toolkit, workflows
- ✓Curated links to official MCP spec, SDKs (TypeScript, Python, Kotlin, Java, C#), and the MCP Inspector
Best for
Learning MCP development — reference guides, a starter template, and example server implementations for building MCP servers and clients.
Caveats
- ⚠Independent learning project, not officially affiliated with the MCP organization
- ⚠The Client Development Guide notes it needs updating for the latest spec changes
- ⚠This is a documentation/reference collection, not a runnable MCP server itself (the example servers live in separate repos)
Clients: Reference for Claude Desktop, Cline, and other MCP-compatible clients
Documentation ↗Reviewed 2026-08-07
Topics
ai-agentsai-developmentcyanheadsdeveloper-guidesllm-toolsmcpmcp-serversmodel-context-protocolmodel-context-protocol-servers
- Stars
- 291★
- Forks
- 30
- Language
- —
- License
- Apache-2.0
- Created
- 2024-11-27
- Last push
- 2025-06-21