Model Context Protocol (MCP) Sunucusu

tecof-app-dev, doküman markdown dosyalarını AI asistanlarına sunmak için yerel stdio MCP sunucusu ve HTTP JSON-RPC/SSE endpoint'i içerir.

---

Yerel MCP Sunucusunu Çalıştırma

Proje dizininde:

npm run mcp

Bu komut ts-node scripts/mcp-server.ts çalıştırır ve stdio transport ile MCP sunucusunu başlatır.

---

Claude Desktop / Cursor Örneği

{
  "mcpServers": {
    "tecof-docs": {
      "command": "npm",
      "args": ["run", "mcp"],
      "cwd": "/Users/ahmetaksungur/Desktop/Tecof/tecof-app-dev"
    }
  }
}

Eğer istemci cwd desteklemiyorsa:

{
  "mcpServers": {
    "tecof-docs": {
      "command": "npx",
      "args": [
        "ts-node",
        "/Users/ahmetaksungur/Desktop/Tecof/tecof-app-dev/scripts/mcp-server.ts"
      ]
    }
  }
}

---

Sunulan MCP Araçları

`get_docs_outline`

Tüm doküman sayfalarının slug ve başlık listesini döner.

`read_doc_page`

Belirli bir doküman sayfasının ham markdown içeriğini döner.

Örnek argüman:

{
  "slug": "public-apis"
}

`search_docs`

Doküman sayfalarında paragraf bazlı metin araması yapar.

Örnek argüman:

{
  "query": "checkout-session"
}

---

HTTP MCP Endpoint'i

Next app içinde /api/mcp endpoint'i de bulunur.

Metot	Kullanım
GET /api/mcp	Sunucu durum bilgisi
GET /api/mcp + Accept: text/event-stream	SSE handshake
POST /api/mcp	Stateless JSON-RPC tool çağrısı

Tool listesi örneği:

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}

Tool çağrısı örneği:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "read_doc_page",
    "arguments": {
      "slug": "storefronts"
    }
  },
  "id": 2
}

---

LLM Dosyaları

Dosya	Açıklama
/llms.txt	Doküman indeks sayfası
/llms-full.txt	Tüm dokümanların tek metin halinde birleşimi

Bu dosyalar dokümanın AI sistemleri tarafından daha rahat okunması için tutulur.