MCP Registry & Auto-Discovery

MCP Nedir?

Model Context Protocol (MCP) - Claude'un dis sistemlerle (DB, API, browser, dosya sistemi) iletisim kurmasini saglayan standart protokol.

Kurulu MCP Server'lar

Kontrol: ~/.mcp.json dosyasini oku.

# Mevcut durumu gor
cd ~/.claude && python3 scripts/mcp/registry.py status

Proje Icin MCP Onerisi

# Proje dizinindeki dosyalara gore oneri al
cd ~/.claude && python3 scripts/mcp/registry.py recommend /path/to/project

# Tum registry'yi gor
cd ~/.claude && python3 scripts/mcp/registry.py list

Bilinen MCP Server'lar

Resmi (Anthropic / MCP)

Server	Kullanim	Sinyal Dosyalari
github	GitHub API (repo, issue, PR)	.github/, .git/
filesystem	Dosya sistemi erisimi	*
postgres	PostgreSQL DB	schema.prisma, *.sql, migrations/
sqlite	SQLite DB	*.db, *.sqlite
docker	Docker yonetimi	Dockerfile, docker-compose.yml
puppeteer	Browser otomasyon	playwright.config., cypress.config.
brave-search	Web arama	-
chrome-devtools	Browser debug	next.config., vite.config.
kubernetes	K8s cluster	k8s/, kustomization.yaml

3rd Party (Kurulu)

Server	Kullanim	Durum
browser-use	AI browser otomasyon	~/.mcp.json'da
codebase-memory	Codebase indexing (64 dil)	~/bin/codebase-memory-mcp
notion	Notion workspace	~/.mcp.json'da
crawl4ai	Web crawling	pip, crwl CLI

~/.mcp.json Konfigurasyonu

{
  "mcpServers": {
    "server-adi": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-X"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Ornek: GitHub MCP Ekleme

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    }
  }
}

Ornek: PostgreSQL MCP

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/db"]
    }
  }
}

Ozel MCP Server Yazma

Minimal Python MCP Server

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def my_tool(param: str) -> str:
    """Tool aciklamasi"""
    return f"Sonuc: {param}"

@mcp.resource("resource://my-data")
def my_resource() -> str:
    """Resource aciklamasi"""
    return "data"

if __name__ == "__main__":
    mcp.run()

Minimal TypeScript MCP Server

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server({ name: "my-server", version: "1.0.0" }, {
  capabilities: { tools: {} }
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: "my_tool",
    description: "Tool aciklamasi",
    inputSchema: { type: "object", properties: { param: { type: "string" } } }
  }]
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => ({
  content: [{ type: "text", text: `Sonuc: ${request.params.arguments?.param}` }]
}));

const transport = new StdioServerTransport();
await server.connect(transport);

mcp.json'a Ekleme

{
  "mcpServers": {
    "my-server": {
      "command": "python3",
      "args": ["/path/to/server.py"]
    }
  }
}

MCP Debug & Troubleshooting

Server Baslatma Testi

# Server'in calistigini dogrula
echo '{"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{}},"id":1}' | npx -y @modelcontextprotocol/server-github 2>/dev/null

Yaygin Sorunlar

Sorun	Cozum
"spawn ENOENT"	command path'i kontrol et, npx/python3 PATH'te mi?
"Connection refused"	Server'i manual calistir, hata mesajini oku
Tool gorunmuyor	Claude Code'u restart et (MCP session basinda yuklenir)
Timeout	args'a timeout flag ekle, veya network kontrol et
Auth hatasi	env degiskenlerini kontrol et (.env degil, mcp.json'a yaz)
Python version uyumsuzluk	Python 3.10+ gerekli, python3 --version kontrol et
pip kurulum hatasi	pip3 install --user --break-system-packages <paket>

Loglar

# Claude Code MCP loglarini gor
ls ~/.claude/logs/mcp*.log 2>/dev/null

# Server'i verbose modda calistir
DEBUG=* npx -y @modelcontextprotocol/server-github 2>&1 | head -50

Auto-Discovery Hook

mcp-discovery.ts hook'u session basinda otomatik calisir:

• Proje dizinindeki dosyalari tarar
• Kurulu olmayan ama faydali MCP server'lari tespit eder
• systemMessage ile oneri gosterir
• Session basina 1 kez calisir

Registry Script

cd ~/.claude && python3 scripts/mcp/registry.py recommend .  # Oneri
cd ~/.claude && python3 scripts/mcp/registry.py status       # Kurulu
cd ~/.claude && python3 scripts/mcp/registry.py list         # Tumu