{"id":24941931,"url":"https://github.com/cyanheads/model-context-protocol-resources","last_synced_at":"2025-10-08T17:10:17.309Z","repository":{"id":265099072,"uuid":"895124092","full_name":"cyanheads/model-context-protocol-resources","owner":"cyanheads","description":"Exploring the Model Context Protocol (MCP) through practical guides, clients, and servers I've built while learning about this new protocol.","archived":false,"fork":false,"pushed_at":"2025-06-21T08:58:08.000Z","size":316,"stargazers_count":226,"open_issues_count":1,"forks_count":20,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-21T09:35:06.453Z","etag":null,"topics":["ai-agents","ai-development","developer-guides","llm-tools","mcp","mcp-servers","model-context-protocol","model-context-protocol-servers"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyanheads.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"cyanheads","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"cyanheads","thanks_dev":null,"custom":null}},"created_at":"2024-11-27T15:49:15.000Z","updated_at":"2025-06-21T08:58:11.000Z","dependencies_parsed_at":"2024-11-27T17:20:34.210Z","dependency_job_id":"098166d6-6594-49af-82f8-0e4f150bf23e","html_url":"https://github.com/cyanheads/model-context-protocol-resources","commit_stats":null,"previous_names":["cyanheads/modelcontextprotocol-tools","cyanheads/model-context-protocol-resources"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cyanheads/model-context-protocol-resources","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyanheads%2Fmodel-context-protocol-resources","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyanheads%2Fmodel-context-protocol-resources/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyanheads%2Fmodel-context-protocol-resources/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyanheads%2Fmodel-context-protocol-resources/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyanheads","download_url":"https://codeload.github.com/cyanheads/model-context-protocol-resources/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyanheads%2Fmodel-context-protocol-resources/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278981518,"owners_count":26079640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-development","developer-guides","llm-tools","mcp","mcp-servers","model-context-protocol","model-context-protocol-servers"],"created_at":"2025-02-02T18:57:22.187Z","updated_at":"2025-10-08T17:10:17.303Z","avatar_url":"https://github.com/cyanheads.png","language":null,"readme":"# Model Context Protocol Resources \u0026 Guides\n\n[![modelcontextprotocol.io](https://img.shields.io/badge/modelcontextprotocol.io-orange.svg)](https://modelcontextprotocol.io/)\n[![MCP SDK - TypeScript](https://img.shields.io/badge/TypeScript-1.12.1-blue.svg)](https://github.com/modelcontextprotocol/typescript-sdk)\n[![MCP SDK - Python](https://img.shields.io/badge/Python-1.9.2-blue.svg)](https://github.com/modelcontextprotocol/python-sdk)\n[![MCP SDK - Kotlin](https://img.shields.io/badge/Kotlin-0.5.0-blue.svg)](https://github.com/modelcontextprotocol/kotlin-sdk)\n[![MCP SDK - Java](https://img.shields.io/badge/Java-0.10.0-blue.svg)](https://github.com/modelcontextprotocol/java-sdk)\n[![MCP SDK - C#](https://img.shields.io/badge/C%23-0.2.0-blue.svg)](https://github.com/modelcontextprotocol/csharp-sdk)\n[![Guide Last Updated](https://img.shields.io/badge/Guide%20Last%20Updated-May%202025-brightgreen.svg)]()\n\nThis repository is a collection of guides, utilities, and server implementations for the **Model Context Protocol (MCP)** created while learning MCP. It reflects my ongoing exploration and development with this exciting new standard for creating powerful Agent capabilities. Questions and feedback are welcome! 🚀\n\n\u003e **Disclaimer:** The resources in this repository (guides, utilities, server implementations, and the MCP TypeScript Template) were developed independently by [cyanheads](https://github.com/cyanheads) while exploring the Model Context Protocol. This project is not officially affiliated with the Model Context Protocol organization. [Links to official MCP resources are provided below.](#official-resources) I appreciate the work of the official MCP team on the specification, SDKs, and documentation!\n\n## 📋 Table of Contents\n\n[Introduction](#-introduction-to-mcp) | [Guides](#-mcp-guides) | [Utilities](#-mcp-utilities) | [Servers](#-mcp-servers) | [Getting Started](#-getting-started) | [Official Resources](#-official-resources)\n\n| Category      | Items                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Template**  | [mcp-ts-template](#-mcp-typescript-template-repo)                                                                                                                                                                                                                                                                                                                                                                                                                                       |\n| **Guides**    | [MCP Client Development](guides/mcp-client-development-guide.md)\u003cbr\u003e[MCP Server Development](guides/mcp-server-development-guide.md)\u003cbr\u003e[cyanheads-custom-llms.txt](guides/cyanheads-custom-mcp-llms-full.md)                                                                                                                                                                                                                                                                           |\n| **Servers**   | [atlas-mcp-server](#-mcp-servers), [clinicaltrialsgov-mcp-server](#-mcp-servers), [filesystem-mcp-server](#-mcp-servers), [git-mcp-server](#-mcp-servers)\u003cbr\u003e[github-mcp-server](#-mcp-servers), [mentor-mcp-server](#-mcp-servers), [ntfy-mcp-server](#-mcp-servers), [obsidian-mcp-server](#-mcp-servers)\u003cbr\u003e[perplexity-mcp-server](#-mcp-servers), [pubmed-mcp-server](#-mcp-servers), [toolkit-mcp-server](#-mcp-servers), [workflows-mcp-server](#-mcp-servers)\u003cbr\u003e[mcp-ts-template](#-mcp-servers), [mcp-ts-template (src/mcp-server)](#-mcp-typescript-template-repo) |\n| **Clients**   | [mcp-ts-template (src/mcp-client)](#-mcp-typescript-template-repo)                                                                                                                                                                                                                                                                                                                                                                                                                      |\n| **Utilities** | [mcp-reporter](#-mcp-utilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                         |\n\n## 🔍 Introduction to MCP\n\nThe **Model Context Protocol (MCP)** is an open standard designed to standardize how AI applications (clients/hosts) connect to and interact with external data sources and tools (servers).\u003cbr\u003eThink of it like USB-C for AI: a universal way to plug capabilities into LLM applications.\n\n**Key Benefits:**\n\n- **Consistent Interface**: Standardized methods for LLMs to access tools and resources.\n- **Enhanced Capabilities**: Empowers LLMs to interact with databases, APIs, local systems, and more.\n- **Security \u0026 Control**: Provides structured access patterns with built-in validation and clear boundaries.\n- **Extensibility**: Easily add new capabilities via servers without modifying core LLM applications.\n- **Modularity**: Develop and maintain specialized functionalities in isolated, reusable server components.\n\nFor a more in-depth introduction to MCP, including its design philosophy and technical details, visit the official site: [modelcontextprotocol.io](https://modelcontextprotocol.io/).\n\n## 🚀 MCP TypeScript Template Repo\n\n| Project                                                             | Description                                                                                                                                                                       |\n| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [**mcp-ts-template**](https://github.com/cyanheads/mcp-ts-template) | Provides a beginner-friendly, production-ready template for building MCP servers and clients. Includes essential utilities, examples, and type safety for a solid starting point. |\n\n## 📚 MCP Guides\n\n| Guide                                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| :------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [**MCP Client Development Guide**](guides/mcp-client-development-guide.md) | Learn how to build applications that consume MCP server capabilities. Covers core architecture, lifecycle, tools/resources, security, examples, and advanced topics. (Note: Needs update for latest spec changes)                                                                                                                                                                                                                             |\n| [**MCP Server Development Guide**](guides/mcp-server-development-guide.md) | Comprehensive guide to building MCP servers. Covers core architecture, protocol fundamentals, server lifecycle, transports (Stdio, Streamable HTTP), building with the TypeScript SDK, defining Tools/Resources/Prompts, advanced features (sampling, roots, streaming, progress, subscriptions, completions), security best practices (updated for Auth Spec `2025-03-26`), troubleshooting, and example implementations. (Updated May 2025) |\n| [**Cyanhead's MCP 'llms.txt'**](guides/cyanheads-custom-mcp-llms-full.md)  | A custom llms.txt for faster TypeScript MCP server development using the high-level SDK (`McpServer`). Tailored for LLM consumption, it covers key concepts, high-level examples, security, and dynamic capabilities, updated for Spec `2025-03-26` \u0026 TS SDK `v1.11.0`.                                                                                                                                                                       |\n\n## 🔧 MCP Utilities\n\n| Project                                                       | Description                                                                                                                                                                     |\n| :------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| [**mcp-reporter**](https://github.com/cyanheads/mcp-reporter) | Generates comprehensive capability reports for MCP servers, helping developers understand available functionality across their MCP ecosystem for documentation and integration. |\n\n## 🔌 MCP Servers\n\nThis repository hosts several example MCP server implementations, showcasing different capabilities:\n\n| Project                                                                                       | Description                                                                                                                                                                                                                                                             |\n| :-------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [**atlas-mcp-server**](https://github.com/cyanheads/atlas-mcp-server)                         | ATLAS (Adaptive Task \u0026 Logic Automation System), a Neo4j-powered task management system designed for LLM Agents. It uses a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows and includes Deep Research scaffolding.                     |\n| [**clinicaltrialsgov-mcp-server**](https://github.com/cyanheads/clinicaltrialsgov-mcp-server) | Enables AI agents to search, retrieve, and analyze clinical study data from ClinicalTrials.gov programmatically via MCP.                                                                                                                                                |\n| [**filesystem-mcp-server**](https://github.com/cyanheads/filesystem-mcp-server)               | Offers platform-agnostic file system capabilities for AI agents via MCP, enabling file and directory management. Features advanced search/replace and directory traversal.                                                                                              |\n| [**git-mcp-server**](https://github.com/cyanheads/git-mcp-server)                             | Provides an enterprise-ready MCP interface for Git operations, allowing LLMs to initialize, clone, branch, commit, and manage repositories via STDIO \u0026 Streamable HTTP.                                                                                                 |\n| [**github-mcp-server**](https://github.com/cyanheads/github-mcp-server)                       | Integrates with the GitHub API via MCP, providing a structured interface for LLM agents to manage repositories, issues, pull requests, code, files, and releases.                                                                                                       |\n| [**mentor-mcp-server**](https://github.com/cyanheads/mentor-mcp-server)                       | Offers AI-powered mentorship via MCP using the Deepseek API, providing LLM agents with a 'second opinion'. Can be used for code review, design critique, writing feedback, and brainstorming.                                                                           |\n| [**ntfy-mcp-server**](https://github.com/cyanheads/ntfy-mcp-server)                           | Integrates with the ntfy.sh push notification service via MCP, enabling LLMs to send highly customizable notifications to external devices.                                                                                                                             |\n| [**obsidian-mcp-server**](https://github.com/cyanheads/obsidian-mcp-server)                   | Enables LLMs to securely interact with Obsidian vaults via MCP, offering token-aware tools for managing notes. Facilitates seamless knowledge base management with Properties management.                                                                               |\n| [**perplexity-mcp-server**](https://github.com/cyanheads/perplexity-mcp-server)               | Unlocks Perplexity's search-augmented AI capabilities for your LLMs via MCP. Provides access to real-time web information with robust error handling and secure validation.                                                                                             |\n| [**pubmed-mcp-server**](https://github.com/cyanheads/pubmed-mcp-server)                       | Connects AI agents to NCBI's PubMed and E-utilities via MCP, enabling search, retrieval, and analysis of biomedical literature.                                                                                                                                         |\n| [**toolkit-mcp-server**](https://github.com/cyanheads/toolkit-mcp-server)                     | Provides essential system utilities and tools for LLM agents via MCP. Features include IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.                                                                        |\n| [**workflows-mcp-server**](https://github.com/cyanheads/workflows-mcp-server)                 | Empowers AI agents with a powerful, declarative workflow engine to discover, understand, and execute complex, multi-step workflows defined in simple YAML files. Easy as asking your LLM \"Create a new workflow to do xyz using the tools you currently have access to\" |\n\n## 🚀 Getting Started\n\n1.  **Explore the Guides**: Understand MCP concepts and development approaches using the [Client](guides/mcp-client-development-guide.md) and [Server](guides/mcp-server-development-guide.md) guides.\n2.  **Select a Server**: Choose one relevant to your needs from the [MCP Servers](#-mcp-servers) section and follow its specific setup instructions in its repository.\n3.  **Connect a Client**: Use an existing MCP-compatible client (like Claude Desktop, Cline, etc.) or build your own using the [Client Development Guide](guides/mcp-client-development-guide.md).\n4.  **Experiment \u0026 Contribute**: Try out the tools and consider contributing via issues or pull requests on the respective project repositories.\n\n## 🔗 Official Resources\n\nKey links to official Model Context Protocol documentation, specifications, and community resources ([modelcontextprotocol.io](https://modelcontextprotocol.io/)):\n\n| Page / Section            | Link Path                                                                                                           |\n| :------------------------ | :------------------------------------------------------------------------------------------------------------------ |\n| Introduction              | [`/introduction`](https://modelcontextprotocol.io/introduction)                                                     |\n| Server Quickstart         | [`/quickstart/server`](https://modelcontextprotocol.io/quickstart/server)                                           |\n| Specification Home        | [`/specification`](https://modelcontextprotocol.io/specification)                                                   |\n| ↳ Architecture            | [`/specification/architecture`](https://modelcontextprotocol.io/specification/architecture)                         |\n| ↳ Base Protocol           | [`/specification/basic`](https://modelcontextprotocol.io/specification/basic)                                       |\n| ↳ Server Features         | [`/specification/server`](https://modelcontextprotocol.io/specification/server)                                     |\n| ↳ Client Features         | [`/specification/client`](https://modelcontextprotocol.io/specification/client)                                     |\n| ↳ Auth Spec (2025-03-26)  | [`/.../authorization`](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)                |\n| Schema Definition (TS)    | [`spec/.../schema.ts`](https://github.com/modelcontextprotocol/specification/blob/main/schema/2025-03-26/schema.ts) |\n| Contributing Guide        | [`CONTRIBUTING.md`](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/CONTRIBUTING.md)         |\n| GitHub Organization       | [`github.com/...`](https://github.com/modelcontextprotocol)                                                         |\n| Specification Discussions | [`spec/discussions`](https://github.com/modelcontextprotocol/specification/discussions)                             |\n| Organization Discussions  | [`orgs/discussions`](https://github.com/orgs/modelcontextprotocol/discussions)                                      |\n| JSON-RPC 2.0 Spec         | [`jsonrpc.org`](https://www.jsonrpc.org/specification)                                                              |\n\n**SDKs \u0026 Tools:**\n\n| Language                       | SDK Repository                                                           |\n| :----------------------------- | :----------------------------------------------------------------------- |\n| TypeScript                     | [typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk) |\n| Python                         | [python-sdk](https://github.com/modelcontextprotocol/python-sdk)         |\n| Kotlin                         | [kotlin-sdk](https://github.com/modelcontextprotocol/kotlin-sdk)         |\n| Java                           | [java-sdk](https://github.com/modelcontextprotocol/java-sdk)             |\n| C#                             | [csharp-sdk](https://github.com/modelcontextprotocol/csharp-sdk)         |\n| **Tool**                       | **Repository**                                                           |\n| MCP Inspector (Debugging tool) | [inspector](https://github.com/modelcontextprotocol/inspector)           |\n\n---\n\n\u003cdiv align=\"center\"\u003e\nCreated by \u003ca href=\"https://github.com/cyanheads\"\u003ecyanheads\u003c/a\u003e and the Model Context Protocol (MCP)\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/cyanheads","https://buymeacoffee.com/cyanheads"],"categories":["📚 Projects (1974 total)","🤖 AI/ML","MCP Resources \u0026 Educational Materials"],"sub_categories":["MCP Servers","Gateways"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyanheads%2Fmodel-context-protocol-resources","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyanheads%2Fmodel-context-protocol-resources","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyanheads%2Fmodel-context-protocol-resources/lists"}