mcpbeat Sign in

MCP Registry Skill for Claude

MCP server registry, auto-discovery, configuration, custom server development guide

1k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
521
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/vibeeval/vibecosystem --skill mcp-registry

The instruction itself

20 sections, as written by the author

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

Other skills for the same job

different authors, same section of the catalogue
Skill Creator
by anthropics
vendor ×10

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

56k tokens scripts
Skill Creator
by vercel-labs
vendor ×10

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

12k tokens scripts
Skill Creator
by JayZeeDesign
×9

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

10k tokens scripts
Template Skill
by JayZeeDesign
×7

Replace with description of the skill and when Claude should use it.

35 tokens
Dispatching Parallel Agents
by ZhanlinCui
×5

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

2k tokens
Skill Development
by anthropics
vendor ×4

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

9k tokens
Find Skills
by sanity-io
vendor ×4

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

1k tokens
Writing Skills
by ZhanlinCui
×4

Use when creating new skills, editing existing skills, or verifying skills work before deployment

26k tokens scripts

How to use it

Copy the folder

Take vibeeval/mcp-registry from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference pip, npx. Without those the skill loads but fails at the first command.