Skip to content

Instantly share code, notes, and snippets.

@eladcandroid
Last active April 21, 2025 18:54
Show Gist options
  • Save eladcandroid/62d477554842256def8f437d70ecc77a to your computer and use it in GitHub Desktop.
Save eladcandroid/62d477554842256def8f437d70ecc77a to your computer and use it in GitHub Desktop.
ROADMAP.md

Getting Started

Description

Model Context Protocol (MCP) is a standardized protocol for connecting AI agents to various external tools and data sources. Imagine it as a USB-C interface - but for AI applications.

Just like USB-C simplifies the way different devices connect to a computer, MCP simplifies the way AI models interact with data, tools, and services.

MCP Diagrams

https://www.claudemcp.com/images/blog/what-is-mcp.png

https://www.descope.com/_next/image?url=https%3A%2F%2Fimages.ctfassets.net%2Fxqb1f63q68s1%2F6R2RtSw84mTFLKfYBPpqNQ%2Ff1ef779c252dde2997f6cc1ab92fa794%2FMCP_general_architecture-min.png&w=1920&q=75

Configuration Files

Claude Desktop - Windows

code ~/Library/Application\ Support/Claude/claude_desktop_config.json
code %APPDATA%\Claude\claude_desktop_config.json
/Users/elad/.cursor/mcp.json

Install uv (Python Deps Management)

brew install uv

Install Node.js

brew install node

Install Docker

brew install --cask docker

Quick Start - Node.js

https://modelcontextprotocol.io/quickstart/server#node

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/Users/elad/dev/node/quickstart-resources/weather-server-typescript/build/index.js"
      ]
    },
  }
}
npx @modelcontextprotocol/inspector node /Users/elad/dev/node/quickstart-resources/weather-server-typescript/build/index.js
Get the weather in NY for Wednesday
Get the weather in NY for Wednesday in celcius format and add a relevant emoji

MCP Server Frameworks

Typescript - https://github.com/punkpeye/fastmcp

Python - https://github.com/jlowin/fastmcp

MCP Client Framework

https://github.com/pietrozullo/mcp-use

MCP Portals

https://mcp.so/

https://mcpserver.cloud/

https://smithery.ai/

https://github.com/punkpeye/awesome-mcp-servers

https://github.com/punkpeye/awesome-mcp-clients

Useful Examples of MCP Servers

GitMCP

  "fastmcp docs": {
    "url": "https://gitmcp.io/punkpeye/fastmcp"
  }
Prompts/Rules
create fastmcp typescript server project using fastmcp docs

Context7 MCP

https://context7.com/

  "context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp@latest"]
  },
Prompts/Rules
How do I protect a route with NextAuth?
How do I protect a route with NextAuth? use context7

always use context7 for library or framework documentation

GitHub MCP

Create a new token here: (Make sure to choose the right permissions)

https://github.com/settings/personal-access-tokens/new

  "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "XXXXX"
      }
  }
Prompts/Rules
List my github repositories
Create a new repository in github named "snake-react", commit all files and push

Supabase MCP

    "supabase": {
      "command": "supabase-mcp-server",
      "env": {
        "SUPABASE_PROJECT_REF": "XXX",
        "SUPABASE_DB_PASSWORD": "XXX",
        "SUPABASE_REGION": "XXX",
        "SUPABASE_ACCESS_TOKEN": "XXX",
        "SUPABASE_SERVICE_ROLE_KEY": "XXX"
      }
    },
Prompts/Rules
Create an AliExpress Store clone Next.js typescript project, with supabase db and google oauth login

Appwrite MCP

    "appwrite": {
      "command": "uvx mcp-server-appwrite --databases --users",
      "env": {
        "APPWRITE_API_KEY": "XXX",
        "APPWRITE_PROJECT_ID": "XXX"
      }
    },
Prompts/Rules
Create a new user

Cursor MCP Installer

https://github.com/matthewdcage/cursor-mcp-installer

Playwright MCP

https://github.com/microsoft/playwright-mcp

Prompts/Rules
Navigate to the https://www.zap.co.il website using Playwright and provide me with the most affordable mobile phones available.

Fetch MCP Server

https://github.com/zcaceres/fetch-mcp

Filesystem MCP

https://smithery.ai/server/@smithery-ai/filesystem

Desktop Commander MCP

https://smithery.ai/server/@wonderwhy-er/desktop-commander

Brave API

https://brave.com/search/api/

Links

CodersClan

https://chat.whatsapp.com/C0BtzCNxshcDdm2z12v0dQ

GoCode

https://gocode.co.il

https://chat.whatsapp.com/GGLefFgcrC7DPpkvSzq40g

https://chat.whatsapp.com/C0Y8Zqu6qDOK4wumd7cNt6

052-5710099

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment