MCP introduction

Model Context Protocol (MCP) to otwarty protokol stworzony przez Anthropic, ktory umozliwia ustandaryzowana komunikacje miedzy modelami LLM a zewnetrznymi zrodlami danych i narzedziami. To fundamentalna zmiana w sposobie budowania aplikacji AI.

Problem ktory rozwiazuje MCP

Przed MCP integracja agentow AI z zewnetrznymi systemami wygladala tak:

Architektura MCP

MCP opiera sie na architekturze klient-serwer z trzema glownymi komponentami:

Komponent	Opis	Przyklady
Host	Aplikacja uzytkownika uruchamiajaca klienty MCP	Claude Desktop, Cursor IDE, VS Code
Client	Komponent wbudowany w host, laczacy z serwerami	MCP SDK (Python, TypeScript)
Server	Serwis eksponujacy narzedzia, dane i prompty	filesystem, github, postgres, slack

Trzy prymitywy MCP

Kazdy serwer MCP moze eksponowac trzy typy elementow:

Aspekt	Tools	Resources	Prompts
Kto kontroluje	LLM (model)	Aplikacja	Uzytkownik
Kierunek	Model → Serwer	Serwer → Model	Serwer → Uzytkownik
Analogia	POST request	GET request	Template

Popularne serwery MCP

Ekosystem MCP rosnie dynamicznie. Oto najpopularniejsze oficjalne i community serwery:

Oficjalne serwery (Anthropic)

Serwer	Funkcja	Instalacja
filesystem	Czytanie, pisanie, wyszukiwanie plikow	@modelcontextprotocol/server-filesystem
github	Repozytoria, PR, Issues, Actions	@modelcontextprotocol/server-github
postgres	Zapytania SQL, schema inspection	@modelcontextprotocol/server-postgres
sqlite	Lokalna baza SQLite	@modelcontextprotocol/server-sqlite
slack	Wiadomosci, kanaly, wyszukiwanie	@modelcontextprotocol/server-slack
puppeteer	Web scraping, screenshots, PDF	@modelcontextprotocol/server-puppeteer
fetch	Pobieranie stron WWW	@modelcontextprotocol/server-fetch

Popularne serwery community

Transporty komunikacji

MCP wspiera rozne metody komunikacji miedzy klientem a serwerem:

Transport	Opis	Uzycie
stdio	Standard input/output (subprocess)	Lokalne serwery, Claude Desktop
HTTP + SSE	Server-Sent Events przez HTTP	Zdalne serwery, produkcja

Konfiguracja Claude Desktop

Aby uzywac serwerow MCP w Claude Desktop, edytuj plik konfiguracyjny:

Lokalizacja pliku

System	Sciezka
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Przyklad konfiguracji

{
  "mcpServers": {
    // Serwer filesystem - dostep do lokalnych plikow
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/Documents",
        "/Users/me/Projects"
      ]
    },
    
    // Serwer GitHub - wymaga tokena
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    },
    
    // Serwer SQLite - lokalna baza danych
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "/Users/me/data/mydb.sqlite"
      ]
    },
    
    // Wlasny serwer Python
    "my-server": {
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "cwd": "/path/to/server"
    }
  }
}

Weryfikacja dzialania

Po skonfigurowaniu serwerow mozesz sprawdzic czy dzialaja:

W Claude Desktop

1. Otworz nowa rozmowe
2. Kliknij ikone 🔧 (narzedzia) w polu wiadomosci
3. Powinienes zobaczyc liste dostepnych serwerow i ich narzedzi
4. Napisz “list my files in Documents” – Claude uzyje serwera filesystem

MCP Inspector (debugging)

# Uruchom inspector dla dowolnego serwera
npx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-filesystem /tmp

# Otworz http://localhost:5173 w przegladarce

Bezpieczenstwo

Podsumowanie