@appaflytech/zeyrek-ai-mcp 0.0.1

package/.env.example

@@ -0,0 +1,46 @@
+# Platform API adresleri (host makinesinden lokal compose icin)
+ORG_API_BASE_URL=http://localhost:7000
+TENANT_API_BASE_URL=http://localhost:5000
+
+# Org cozumu: istekler Host: {ORGANIZATION}.{HOST_SUFFIX} header'i ile gider
+ORGANIZATION=zeyrek-local
+HOST_SUFFIX=localhost
+
+# Varsayilanlar; tool parametresi her zaman ezer
+DEFAULT_ENVIRONMENT=production
+DEFAULT_PROJECT=
+
+# local: kimlik asagidaki alanlardan, passthrough: istemcinin Authorization header'i aynen gecer
+# local modda ya TOKEN (hazir Bearer JWT) ya da USERNAME+PASSWORD verin
+AUTH_MODE=local
+TOKEN=
+USERNAME=
+PASSWORD=
+
+# Politika lint'i: strict (block kurallari istegi durdurur) | warn (hepsi uyariya iner) | off
+POLICY=strict
+
+# Tool cagrisi gunlugu: her cagri okunabilir tek blok olarak dosyaya yazilir.
+# detail (varsayilan) istek/yanit govdelerini de yazar | summary govdesiz | off kapali.
+# LOG_FILE verilirse tek sabit dosyaya yazilir, verilmezse LOG_DIR altinda gunluk dosya
+# (gateway-YYYY-AA-GG.log). Parola/token alanlari her seviyede *** ile maskelenir.
+LOG_LEVEL=detail
+LOG_DIR=
+LOG_FILE=
+LOG_MAX_BODY_CHARS=2000
+
+# Yanit budama esigi (bayt) ve istek zaman asimi (ms)
+MAX_RESPONSE_BYTES=262144
+REQUEST_TIMEOUT_MS=100000
+
+# generate-schemas icin swagger adresleri. Bos birakilirsa sirayla denenir:
+# 1) asagidaki override, 2) {API_BASE_URL}/swagger/v1/swagger.json, 3) localhost:3000 frontend proxy'si
+ORG_SWAGGER_URL=
+TENANT_SWAGGER_URL=
+
+# Bos = tum moduller (148 tool). Hazir kumeler: core (veri+mantik, 92), studio (sayfa
+# tasarimi, 45), admin (template/organizasyon/deployment, 15). Kume ve tekil modul adi
+# karisik yazilabilir. Ornek: core,studio  |  entity,row,microservice
+MODULES=
+
+MCP_PORT=5100

package/README.md

@@ -0,0 +1,260 @@
+# ngapps-mcp-gateway
+
+NgApps platformunu MCP tool'ları olarak sunan bağımsız gateway — veri/mantık tarafı (project,
+application, datasource, entity, row, microservice, query, workflow, automation, dto, view) ve
+Studio tasarım tarafı (page, component, flow, layout, variable, folder, file) birlikte, **152
+tool / 24 modül**. Durum + yol haritası:
+[`docs/00-durum-ve-yol-haritasi.md`](docs/00-durum-ve-yol-haritasi.md);
+tasarım: [`docs/`](docs/01-vizyon-ve-kapsam.md). Platform koduna
+referans vermez; iki API'yi HTTP üzerinden sarar, istekler MVC binding'den geçtiği için
+FluentValidation aynen çalışır.
+
+## Kurulum
+
+```bash
+cd zeyrek-mcp
+npm install
+cp .env.example ../.env
+```
+
+`.env` **repo kökünde**, `.mcp.json`'ın yanında durur (kök `.gitignore`'da `/.env` ile korunur).
+Sunucu şu sırayla arar, ilk bulunan anahtar kazanır: `<çalışma dizini>/.env` →
+`<paket>/.env` → `<paket>/../.env`.
+
+> `npm install` yalnız `npm run dev` için değil: repo kökündeki `.mcp.json` sunucuyu
+> `zeyrek-mcp/node_modules/.bin/tsx` ile başlatır. Bağımlılıklar kurulu değilken MCP istemcisi
+> **hata vermeden sıfır tool ile** bağlanır — repoyu yeni klonladıysanız ilk adım budur.
+
+Ayarlar `.env` yerine (ya da onunla birlikte) repo kökündeki `.mcp.json`'ın `env` bloğundan da
+verilebilir; env bloğu her zaman `.env`'i ezer — ayrıntı [npm paketi olarak
+kurulum](#npm-paketi-olarak-kurulum). Asgari şunlar gerekir:
+
+| Değişken | Örnek | Not |
+|----------|-------|-----|
+| `ORG_API_BASE_URL` | `http://localhost:7000` | Organization.API |
+| `TENANT_API_BASE_URL` | `http://localhost:5000` | Tenant.API |
+| `ORGANIZATION` | `zeyrek-local` | Org subdomain'i; istekler `Host: {org}.{suffix}` ile gider |
+| `USERNAME` / `PASSWORD` | | `/connect/token` ile takas edilir (AuthMode=local) |
+| `DEFAULT_PROJECT` | `crm` | Opsiyonel; tool'daki `project` parametresi her zaman ezer |
+
+## Çalıştırma
+
+```bash
+npm run dev
+```
+
+Sağlık: `http://localhost:5100/healthz`. Sunucu stateless streamable HTTP konuşur (`/mcp`,
+yalnız POST); `npm run start:stdio` ile stdio kipi de var.
+
+## Tool çağrısı günlüğü
+
+Her MCP tool çağrısı, okunmak için biçimlenmiş tek bir blok olarak dosyaya yazılır — varsayılan
+`zeyrek-mcp/logs/gateway-YYYY-MM-DD.log` (günlük dosya, `.gitignore`'da). Amaç: bir çağrının ne
+yapmaya çalıştığını, içeriden hangi duraklardan geçtiğini ve nerede patladığını **koda inmeden**
+okuyabilmek.
+
+```
+┌─ #1 · 11:27:27.082 · platform_whoami — Oturum bilgisi
+│  amaç   : Gateway'in platformda kimin adına çalıştığını döner; auth kurulumunu doğrulamak için ilk çağrılacak tool.
+│  girdi  : (parametresiz)
+│  adımlar:
+│    +2ms      kimlik →    önbellekte geçerli token yok — POST http://localhost:7000/connect/token · kullanıcı admin@zeyrek.com
+│    +229ms    kimlik ←    HTTP 200 · token alındı, önbellekte 63158340 sn geçerli
+│    +229ms    istek →     GET http://localhost:7000/connect/userinfo · org api · env=development
+│    +237ms    yanıt ←     HTTP 200 · 8 ms · 174 B
+│                          gövde: {"sub":"01917edf-…","email":"admin@zeyrek.com","role":["super-admin"]}
+└─ SONUÇ  : başarılı · 238 ms · 4 adım · 137 B yanıt
+```
+
+Adım etiketleri: `politika` (lint kuralları; `politika ✕` isteği hiç göndermez), `düzeltme`
+(gateway'in gövdeye uyguladığı otomatik düzeltmeler — yanıttaki `gatewayNormalized`), `kimlik →/←`
+(`/connect/token` turu), `istek →/yanıt ←` (platform API turu, tam URL + süre + boyut),
+`kırpma ✂` (yanıt `MAX_RESPONSE_BYTES` sınırını aştı), `hata ✕` (yakalanan hata: sınıf,
+HTTP kodu, mesaj, ilk 3 stack satırı). Tool gövdesine hiç girmeyen çağrılar — yanlış tool adı ya da
+parametre şemasına takılan gövde — `MCP KATMANI REDDETTİ` bloğu olarak düşer; bunlar aksi hâlde
+hiçbir yerde görünmezdi.
+
+Arama: `SONUÇ  : HATA` tüm başarısız çağrılar, `hata ✕` hata satırları, `#<n>` tek bir çağrı.
+
+| Değişken | Varsayılan | Not |
+|----------|-----------|-----|
+| `LOG_LEVEL` | `detail` | `detail` istek/yanıt gövdelerini de yazar · `summary` yalnız durak + boyut + hata gövdeleri · `off` hiç dosya açmaz |
+| `LOG_DIR` | `zeyrek-mcp/logs` | Günlük dosyaların klasörü |
+| `LOG_FILE` | — | Verilirse tek sabit dosyaya yazar (tarih döndürmesi kapanır) |
+| `LOG_MAX_BODY_CHARS` | `2000` | Tek bir gövde/parametre önizlemesinin karakter sınırı |
+
+Adı `pass|secret|token|authorization|api key|credential|connectionString` desenine uyan alanlar
+`***` ile maskelenir (`girdi` satırında ve gövde önizlemelerinde). Günlükleme yazma hatası tool
+çağrısını **düşürmez**: ilk hatada stderr'e tek satır yazılıp günlükleme kapatılır.
+
+## Claude Code kaydı
+
+```bash
+claude mcp add ngapps --transport http http://localhost:5100/mcp
+```
+
+stdio alternatifi (port gerekmez, sunucuyu istemci başlatır):
+
+```bash
+claude mcp add ngapps -- npx tsx <repo>/zeyrek-mcp/src/index.ts --stdio
+```
+
+İlk doğrulama: oturumda `platform_whoami` tool'unu çağırtın — kimlik ve org çözümü tek seferde
+test edilir.
+
+## npm paketi olarak kurulum
+
+Repoyu klonlamadan, yayınlanmış paketle. Tüm ayarlar `.mcp.json`'ın `env` bloğundan gelir;
+`.env` dosyasına gerek yoktur:
+
+```json
+{
+  "mcpServers": {
+    "ngapps": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@appaflytech/zeyrek-ai-mcp@latest", "--stdio"],
+      "env": {
+        "ORG_API_BASE_URL": "http://localhost:17000",
+        "TENANT_API_BASE_URL": "http://localhost:15000",
+        "ORGANIZATION": "zeyrek-test",
+        "HOST_SUFFIX": "zeyrek.local",
+        "DEFAULT_PROJECT": "emrah",
+        "DEFAULT_ENVIRONMENT": "development",
+        "USERNAME": "admin@zeyrek.com",
+        "PASSWORD": "${PASSWORD}",
+        "MODULES": "core",
+        "LOG_DIR": "logs"
+      }
+    }
+  }
+}
+```
+
+Ayar öncelik sırası: **`.mcp.json` env bloğu → `.env` (varsa; repo içinden çalışırken kökte
+durur) → şemadaki varsayılan.** `.env.example` tüm değişkenlerin tam listesidir. npx ile kurulan
+pakette `.env` yoktur, tüm ayarlar env bloğundan gelir.
+
+- `.mcp.json` sürüm kontrolündeyse parolayı düz yazmayın: Claude Code `${PASSWORD}` ve
+  `${PASSWORD:-varsayılan}` genişletmesi yapar, değer kabuk ortamından gelir.
+- Genişletme **istemciye bağlıdır**: Claude Code açar, VS Code'un kendi MCP istemcisi açmaz ve
+  metni olduğu gibi geçirir. Bu yüzden sunucu, açılmamış `${…}` yer tutucusunu boş değerle aynı
+  sayıp **düşürür** — ayar `.env`'den ya da şema varsayılanından doldurulur, sunucu yer tutucu
+  metinle patlamaz (`dropUnusableEnvironment`). Ortama göre gerçekten değişen ayarı `.env`'e
+  koymak her istemcide çalışan yoldur.
+- Boş bırakılan (`""`) alanlar **tanımsız** sayılır; varsayılana düşer ya da `.env`'den
+  doldurulur. Yani `"${MODULES:-}"` yazmak alanı hiç yazmamakla aynıdır.
+- Değişken adları ön eksizdir (`USERNAME`, `PASSWORD`, `TOKEN`, `LOG_LEVEL` …), yani kabuk
+  ortamındaki aynı adlı değişkenlerle çakışabilir — `USERNAME` Windows'ta yerleşiktir. Bu yüzden
+  `.mcp.json`'da `${USERNAME:-…}` gibi genişletme kullanmayın; değeri düz yazın ya da `.env`'e
+  koyun.
+- `LOG_DIR` verilmezse günlükler **çalışma dizininin** altındaki `logs/` klasörüne yazılır.
+- Konfigürasyon geçersizse sunucu stderr'e tek satır sebep yazıp `exit 1` yapar — istemci artık
+  sessizce sıfır tool ile bağlanmaz.
+
+Yayınlama (paket bakımcısı için):
+
+```bash
+cd zeyrek-mcp
+npm run typecheck && npm test
+npm publish          # prepack: tsc -p tsconfig.build.json + varlık kopyalama
+```
+
+`dist/` içine `src/resources/{schemas,guides,examples}` altındaki 41 JSON/MD varlığı
+`scripts/copy-assets.ts` kopyalar — `tsc` tek başına bunları taşımaz.
+
+## Kullanım kalıpları
+
+- **Keşif önce:** `project_list` → `project_get` (environment id'leri burada) →
+  `datasource_list` → `entity_list`.
+- **Derin gövdeler geçirgendir:** `entity_create` / `workflow_create` / `microservice_create`
+  `definition` parametresini API'ye birebir geçirir. En iyi şablon, mevcut bir kaydın `*_get`
+  çıktısıdır; step şeması için `workflow_step_schema` kullanılır.
+- **Test kası:** `microservice_execute` gerçek runtime yolunu çağırır; dönen `httpStatus`
+  microservice'in kendi sonucudur. Beklenmedik sonuçta aynı parametrelerle
+  `microservice_debug` çağırın — adım adım `executionItems` ağacı döner.
+- **Asenkron işler:** `automation_trigger` fire-and-forget'tır (`automation_histories` ile
+  izlenir); `deployment_start` bir saga başlatır (`deployment_status` ile izlenir).
+- **Sayfa tasarımı:** `layout_*` → `page_create` → `page_state` → `page_schema_patch`
+  (micro-op); olay akışları `flow_*` + `set_event`. Şema değişikliği `page_update` ile değil
+  `page_schema_patch` ile yapılır; `page_build` diye bir tool **yok** (platform ucu üründe
+  olmayan ayrı bir servise delege ediyor) — ayrıntı `platform_guide('page')`.
+- **Yazma tool'ları replace gövdeleri merge eder:** `page_update`, `layout_update`,
+  `component_update` kaydı önce okur, yalnız verdiğiniz alanları değiştirir; şema/olay kaybı
+  olmaz. `flow_*` uçlarının istediği barındırıcı gövdesini de gateway kurar.
+- Tool seti `MODULES` ile daraltılabilir: tekil modül adı (`entity,row,microservice`)
+  ya da hazır küme — `core` (92 tool: veri + mantık), `studio` (49 tool: sayfa tasarımı),
+  `admin` (15 tool: template, organizasyon, deployment). Küme ve modül adları karışık
+  yazılabilir: `MODULES=core,page`.
+
+## Bilgi katmanı (Faz 1.5)
+
+Tasarım: [`docs/07-bilgi-katmani.md`](docs/07-bilgi-katmani.md).
+Üç savunma hattı:
+
+- **Rehberler:** `platform_guide` tool'u (workflow, microservice, entity, page, component,
+  html, middleware, view, expressions, getting-started, modify-existing) + `ngapps://guides/*`
+  resource'ları. Bir modülde ilk yazma işleminden önce ilgili rehber okunmalı; tool
+  açıklamaları bunu söyler. Komponent davranış bilgisi ayrıca `component_get` çıktısında
+  `knowledge` alanı olarak döner (`src/knowledge/componentCatalog.ts`).
+- **Altın örnekler:** `ngapps://examples/*` — boş org'da şablon kaynağı. Şu an sentetik seed;
+  platform ayaktayken `npm run harvest-examples -- --project qm` ham hasadı
+  `src/resources/examples/harvested/` altına yazar, küratörlükten geçen dosyalar `examples/`
+  köküne taşınır.
+- **Politika lint'i:** entity/microservice/workflow/automation create/update/preview gövdeleri
+  API'ye gitmeden `src/knowledge/rules.ts` kurallarından geçer. Block kuralları (MS-001 join'li
+  kaynakta boş selectFields, WF-001 kopuk step grafı, WF-002 workflow'da returnDtoId, WF-005
+  tip×step matrisi) isteği durdurup düzeltme önerisi döner; warn bulguları yanıta
+  `policyFindings` olarak eklenir. `POLICY=strict|warn|off`, çağrı başına kaçış:
+  `policyOverride: true`. Kural envanteri: `docs/08-kural-envanteri.md`.
+
+## Büyük şema erişimi
+
+Tam gövdeyi LLM bağlamına sokmadan çalışma modeli
+([tasarım](docs/09-buyuk-sema-stratejisi.md)):
+
+1. `project_overview` — projenin kompakt haritası (id/ad/tip envanteri)
+2. `workflow_get` / `microservice_get` / `entity_get` + `view: 'outline'` — iskelet
+3. `view: 'part', part: 'steps[id=...]'` — tek parçanın tam hâli
+4. `workflow_patch` / `microservice_patch` / `entity_patch` — RFC 6902 işlemleri; gateway
+   get→patch→lint→put zincirini kendi belleğinde yürütür, yanıt outline özetidir
+
+## Şema kaynakları
+
+API'ler ayaktayken:
+
+```bash
+npm run generate-schemas
+```
+
+Swagger'dan seçili komut şemalarını `src/resources/schemas/` altına yazar; sunucu bunları
+`ngapps://schemas/*` MCP resource'ları olarak yayınlar (`ngapps://schemas/index` dizindir).
+Üretilen JSON'lar klasörde durur ve gateway'le birlikte taşınır — script yalnızca yeniden
+üretmek için gerekir.
+
+Swagger adresi sırayla denenir: `ORG_SWAGGER_URL` / `TENANT_SWAGGER_URL`
+override'ları → `{API_BASE_URL}/swagger/v1/swagger.json` → `localhost:3000` frontend proxy'si
+(`/api/org` ve `/api`). Hangi adresin kullanıldığı çıktıda yazar.
+
+## Test
+
+```bash
+npm run typecheck
+npm test
+```
+
+Testler gerçek ağa çıkmaz (undici `MockAgent`); MCP katmanı `InMemoryTransport` üzerinden
+gerçek el sıkışmasıyla doğrulanır.
+
+## Bilinen sınırlar (PoC)
+
+- `project_create/update` `LoaderImage` yüklemez (multipart dosya kapsam dışı; urlencoded form
+  kullanılır).
+- `row_list.selectedFields` kırpması gateway tarafında yapılır: platform `GetRowsQuery.SelectedFields`
+  alanını yalnızca many-to-many alt sorgularını daraltmak için okur, skaler kolonlar için her zaman
+  tam satır döner. Gateway satırları verilen alanlara (+`id`) indirger; alan eşleşmesi
+  büyük/küçük harf duyarsızdır.
+- `microservice_execute` dosya (stream) çıktısını içerik olarak aktarmaz.
+- Passthrough auth modu tanımlı ama uçtan uca tatbik edilmedi; PoC `local` modda test edilir.
+- Docker/compose servisi bilinçli olarak ertelendi (Faz 3 backlog'u —
+  `docs/00-durum-ve-yol-haritasi.md` §5.4).

package/dist/config.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+export const moduleNames = [
+    'platform',
+    'project',
+    'application',
+    'datasource',
+    'entity',
+    'row',
+    'microservice',
+    'query',
+    'workflow',
+    'automation',
+    'dto',
+    'view',
+    'page',
+    'component',
+    'flow',
+    'layout',
+    'variable',
+    'folder',
+    'file',
+    'access',
+    'template',
+    'organization',
+    'dependency',
+    'deployment'
+];
+export const modulePresets = {
+    core: ['platform', 'project', 'application', 'datasource', 'entity', 'row', 'microservice', 'query', 'workflow', 'automation', 'dto', 'view', 'dependency'],
+    studio: ['platform', 'page', 'component', 'flow', 'layout', 'variable', 'folder', 'file', 'access'],
+    admin: ['platform', 'template', 'organization', 'deployment']
+};
+function expandModuleNames(entries) {
+    const modules = [];
+    const unknown = [];
+    for (const entry of entries) {
+        const preset = modulePresets[entry];
+        if (preset) {
+            modules.push(...preset);
+            continue;
+        }
+        if (moduleNames.includes(entry)) {
+            modules.push(entry);
+            continue;
+        }
+        unknown.push(entry);
+    }
+    return { modules: [...new Set(modules)], unknown };
+}
+const environmentSchema = z.object({
+    ORG_API_BASE_URL: z.string().url(),
+    TENANT_API_BASE_URL: z.string().url(),
+    ORGANIZATION: z.string().min(1),
+    HOST_SUFFIX: z.string().min(1).default('localhost'),
+    DEFAULT_ENVIRONMENT: z.string().min(1).default('production'),
+    DEFAULT_PROJECT: z.string().optional(),
+    AUTH_MODE: z.enum(['local', 'passthrough']).default('local'),
+    TOKEN: z.string().optional(),
+    USERNAME: z.string().optional(),
+    PASSWORD: z.string().optional(),
+    POLICY: z.enum(['strict', 'warn', 'off']).default('strict'),
+    MAX_RESPONSE_BYTES: z.coerce.number().int().positive().default(262144),
+    REQUEST_TIMEOUT_MS: z.coerce.number().int().positive().default(100000),
+    MODULES: z.string().optional(),
+    LOG_LEVEL: z.enum(['off', 'summary', 'detail']).default('detail'),
+    LOG_DIR: z.string().min(1).optional(),
+    LOG_FILE: z.string().min(1).optional(),
+    LOG_MAX_BODY_CHARS: z.coerce.number().int().positive().default(2000),
+    MCP_PORT: z.coerce.number().int().positive().default(5100)
+});
+export const environmentKeys = Object.keys(environmentSchema.shape);
+/**
+ * `.mcp.json` env bloğundan gelen KULLANILAMAZ değerleri süreç ortamından düşürür ki `.env`
+ * (dotenv mevcut anahtarları ezmez) ve şema varsayılanları devreye girebilsin. İki hâl
+ * kullanılamazdır: boş string (README §Ayar öncelik sırası: boş = tanımsız) ve genişletilmemiş
+ * `${VAR:-…}` yer tutucusu — Claude Code bu sözdizimini açar, VS Code'un kendi MCP istemcisi
+ * açmadan olduğu gibi geçirir ve düşürülmezse konfigürasyon doğrulaması yer tutucu metinle patlar.
+ */
+export function dropUnusableEnvironment(env) {
+    for (const key of environmentKeys) {
+        const value = env[key];
+        if (value === '' || (value !== undefined && /^\$\{[^}]*\}$/.test(value))) {
+            delete env[key];
+        }
+    }
+}
+export function loadConfig(env) {
+    const parsed = environmentSchema.safeParse(env);
+    if (!parsed.success) {
+        const missing = parsed.error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`).join('; ');
+        throw new Error(`Gateway konfigürasyonu geçersiz — ${missing}. Gerekli değişkenler için zeyrek-mcp/.env.example dosyasına bakın.`);
+    }
+    const values = parsed.data;
+    if (values.AUTH_MODE === 'local' && !values.TOKEN && (!values.USERNAME || !values.PASSWORD)) {
+        throw new Error('AUTH_MODE=local için TOKEN ya da USERNAME + PASSWORD zorunludur.');
+    }
+    if (values.AUTH_MODE === 'passthrough' && (values.TOKEN || values.USERNAME || values.PASSWORD)) {
+        throw new Error('AUTH_MODE=passthrough iken TOKEN/USERNAME/PASSWORD tanımlanamaz — kimlik istemciden gelir.');
+    }
+    const requested = values.MODULES
+        ? values.MODULES.split(',').map(name => name.trim()).filter(name => name.length > 0)
+        : [...moduleNames];
+    const { modules, unknown: unknownModules } = expandModuleNames(requested);
+    if (unknownModules.length > 0) {
+        throw new Error(`MODULES bilinmeyen modül/küme içeriyor: ${unknownModules.join(', ')}. Kümeler: ${Object.keys(modulePresets).join(', ')}. Modüller: ${moduleNames.join(', ')}.`);
+    }
+    return {
+        orgApiBaseUrl: values.ORG_API_BASE_URL.replace(/\/+$/, ''),
+        tenantApiBaseUrl: values.TENANT_API_BASE_URL.replace(/\/+$/, ''),
+        organization: values.ORGANIZATION,
+        hostSuffix: values.HOST_SUFFIX,
+        defaultEnvironment: values.DEFAULT_ENVIRONMENT,
+        defaultProject: values.DEFAULT_PROJECT,
+        authMode: values.AUTH_MODE,
+        token: values.TOKEN,
+        username: values.USERNAME,
+        password: values.PASSWORD,
+        policyMode: values.POLICY,
+        maxResponseBytes: values.MAX_RESPONSE_BYTES,
+        requestTimeoutMs: values.REQUEST_TIMEOUT_MS,
+        modules: modules,
+        logLevel: values.LOG_LEVEL,
+        logDirectory: values.LOG_DIR,
+        logFile: values.LOG_FILE,
+        logMaxBodyChars: values.LOG_MAX_BODY_CHARS,
+        port: values.MCP_PORT
+    };
+}

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { configureLogging, logGatewayEvent } from './observability/trace.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Platform, requestAuthStorage } from './platform/http.js';
+import { createGatewayServer } from './server.js';
+import { fileURLToPath } from 'node:url';
+import { dropUnusableEnvironment, loadConfig } from './config.js';
+import { join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+import express from 'express';
+import dotenv from 'dotenv';
+import pino from 'pino';
+dropUnusableEnvironment(process.env);
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const envFiles = [join(process.cwd(), '.env'), join(packageRoot, '.env'), join(packageRoot, '..', '.env')];
+for (const envFile of envFiles) {
+    if (existsSync(envFile)) {
+        dotenv.config({ path: envFile });
+    }
+}
+const logger = pino(pino.destination(2));
+let config;
+try {
+    config = loadConfig(process.env);
+}
+catch (error) {
+    logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+}
+const platform = new Platform(config);
+const useStdio = process.argv.includes('--stdio');
+configureLogging(config, useStdio ? 'stdio' : 'http');
+if (useStdio) {
+    if (config.authMode === 'passthrough') {
+        logger.error('stdio kipi passthrough auth ile kullanılamaz; AUTH_MODE=local yapın.');
+        process.exit(1);
+    }
+    const server = createGatewayServer(platform);
+    await server.connect(new StdioServerTransport());
+    logger.info({ modules: config.modules }, 'ngapps mcp gateway stdio üzerinde hazır');
+    logGatewayEvent('gateway stdio üzerinde hazır');
+}
+else {
+    const app = express();
+    app.use(express.json({ limit: '8mb' }));
+    app.get('/healthz', (_request, response) => {
+        response.json({ ok: true, organization: config.organization, modules: config.modules });
+    });
+    app.post('/mcp', async (request, response) => {
+        const server = createGatewayServer(platform);
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+        response.on('close', () => {
+            void transport.close();
+            void server.close();
+        });
+        try {
+            await requestAuthStorage.run(request.headers.authorization, async () => {
+                await server.connect(transport);
+                await transport.handleRequest(request, response, request.body);
+            });
+        }
+        catch (error) {
+            logger.error({ err: error }, 'mcp isteği başarısız');
+            logGatewayEvent(`MCP isteği taşıma katmanında başarısız oldu: ${error instanceof Error ? `${error.name}: ${error.message}` : String(error)}`);
+            if (!response.headersSent) {
+                response.status(500).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32603, message: 'Internal server error' },
+                    id: null
+                });
+            }
+        }
+    });
+    const rejectNonPost = (_request, response) => {
+        response.status(405).json({
+            jsonrpc: '2.0',
+            error: { code: -32000, message: 'Method not allowed: gateway stateless çalışır, yalnızca POST kabul eder' },
+            id: null
+        });
+    };
+    app.get('/mcp', rejectNonPost);
+    app.delete('/mcp', rejectNonPost);
+    app.listen(config.port, () => {
+        logger.info({ port: config.port, modules: config.modules, authMode: config.authMode }, 'ngapps mcp gateway http üzerinde hazır');
+        logGatewayEvent(`gateway http üzerinde hazır · port ${config.port}`);
+    });
+}