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
View on GitHub ↗
Stars
291★
Forks
30
Language
License
Apache-2.0
Created
2024-11-27
Last push
2025-06-21