vibeeval/mcp-registry

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