@akredit/acik-mcp 0.1.0 → 0.5.0

package/dist/apps/acik-mcp/src/http.js

@@ -6,6 +6,26 @@
 // Sınırlar: gövde en çok 512 KB; adres başına kova (varsayılan 60 istek, saniyede 1 dolar).
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 import { acikSunucu } from "./sunucu.js";
+/**
+ * İstemci adresi. Sıra: cf-connecting-ip (Cloudflare yazar, istemci değiştiremez), x-real-ip (ters vekil yazar),
+ * x-forwarded-for'un sondan `guvenilenVekil`. öğesi. İlk öğe asla kullanılmaz: istemci onu istediği gibi yazabilir.
+ * Not: cf-connecting-ip'ye ancak köken sunucuya yalnız Cloudflare üzerinden erişiliyorsa güvenilebilir.
+ */
+export function istemciAdresi(basliklar, guvenilenVekil = 1) {
+    const cf = basliklar.get("cf-connecting-ip")?.trim();
+    if (cf)
+        return cf.slice(0, 64);
+    const gercek = basliklar.get("x-real-ip")?.trim();
+    if (gercek)
+        return gercek.slice(0, 64);
+    const liste = (basliklar.get("x-forwarded-for") ?? "")
+        .split(",")
+        .map((x) => x.trim())
+        .filter(Boolean);
+    const n = Math.max(1, Math.floor(guvenilenVekil));
+    const adres = liste.length >= n ? liste[liste.length - n] : undefined;
+    return adres ? adres.slice(0, 64) : "bilinmeyen";
+}
 export const CORS_BASLIKLARI = {
     "access-control-allow-origin": "*",
     "access-control-allow-methods": "POST, GET, OPTIONS",
@@ -18,7 +38,11 @@ const json = (govde, durum, ek = {}) => new Response(JSON.stringify(govde), {
     headers: { "content-type": "application/json; charset=utf-8", ...CORS_BASLIKLARI, ...ek },
 });
 const rpcHata = (durum, code, message, ek = {}) => json({ jsonrpc: "2.0", id: null, error: { code, message } }, durum, ek);
-/** Süreç içi kova. Adres sayısı sınırlıdır; dolan tablo en eski kayıtlardan boşaltılır. */
+/**
+ * Süreç içi kova. Adres sayısı sınırlıdır. Tablo dolunca önce süresi geçmiş (jetonu yeniden dolmuş, yani yeni
+ * gelen bir adresle aynı durumdaki) kayıtlar silinir; yine doluysa yeni adres reddedilir. Böylece çok sayıda sahte
+ * adresle eski kayıtları itip gerçek adreslerin sayacı sıfırlanamaz.
+ */
 export class AdresKovasi {
     kovalar = new Map();
     kapasite;
@@ -32,11 +56,10 @@ export class AdresKovasi {
     al(adres, simdiMs) {
         let k = this.kovalar.get(adres);
         if (!k) {
-            if (this.kovalar.size >= this.enCokAdres) {
-                const ilk = this.kovalar.keys().next().value;
-                if (ilk !== undefined)
-                    this.kovalar.delete(ilk);
-            }
+            if (this.kovalar.size >= this.enCokAdres)
+                this.temizle(simdiMs);
+            if (this.kovalar.size >= this.enCokAdres)
+                return { izin: false, bekle: Math.ceil(1 / this.saniyede) };
             k = { jeton: this.kapasite, son: simdiMs };
             this.kovalar.set(adres, k);
         }
@@ -47,8 +70,46 @@ export class AdresKovasi {
         k.jeton -= 1;
         return { izin: true, bekle: 0 };
     }
+    /** Jetonu yeniden kapasiteye dolmuş kayıtları siler. */
+    temizle(simdiMs) {
+        for (const [a, k] of this.kovalar)
+            if (k.jeton + ((simdiMs - k.son) / 1000) * this.saniyede >= this.kapasite)
+                this.kovalar.delete(a);
+    }
+    get boyut() {
+        return this.kovalar.size;
+    }
+}
+/** Gövdeyi bayt sayarak okur; sınır aşılınca akışı iptal eder. content-length olmasa da (chunked) bellek sınırlı kalır. */
+export async function govdeOku(istek, enBuyuk) {
+    const uzunluk = Number(istek.headers.get("content-length") ?? "0");
+    if (uzunluk > enBuyuk)
+        return { tur: "buyuk" };
+    if (!istek.body)
+        return { tur: "tamam", tampon: new Uint8Array(0) };
+    const okuyucu = istek.body.getReader();
+    const parcalar = [];
+    let toplam = 0;
+    for (;;) {
+        const { done, value } = await okuyucu.read();
+        if (done)
+            break;
+        toplam += value.byteLength;
+        if (toplam > enBuyuk) {
+            await okuyucu.cancel().catch(() => { });
+            return { tur: "buyuk" };
+        }
+        parcalar.push(value);
+    }
+    const tampon = new Uint8Array(toplam);
+    let i = 0;
+    for (const p of parcalar) {
+        tampon.set(p, i);
+        i += p.byteLength;
+    }
+    return { tur: "tamam", tampon };
 }
-/** Gövdeden günlüğe yazılacak tek bilgi: yöntem ve (tools/call ise) araç adı. İçerik okunmaz. */
+/** Gövdeden günlüğe yazılacak tek bilgi: yöntem ve (tools/call ya da prompts/get ise) araç ya da istem adı. İçerik okunmaz. */
 function yontemVeArac(govde) {
     const ilk = Array.isArray(govde) ? govde[0] : govde;
     if (!ilk || typeof ilk !== "object")
@@ -58,7 +119,9 @@ function yontemVeArac(govde) {
     const ad = ilk.params?.name;
     return {
         yontem,
-        arac: yontem === "tools/call" && typeof ad === "string" ? ad.replace(/[^a-z_]/gu, "").slice(0, 40) : null,
+        arac: (yontem === "tools/call" || yontem === "prompts/get") && typeof ad === "string"
+            ? ad.replace(/[^a-z_]/gu, "").slice(0, 40)
+            : null,
     };
 }
 export function acikMcpIsleyici(s = {}) {
@@ -66,7 +129,8 @@ export function acikMcpIsleyici(s = {}) {
     const enBuyuk = s.enBuyukGovde ?? 512 * 1024;
     const kova = new AdresKovasi(s.hiz?.kapasite ?? 60, s.hiz?.saniyede ?? 1);
     const gunluk = s.gunluk ?? ((k) => console.info(JSON.stringify({ olay: "acik_mcp", ...k })));
-    const adresBasligi = s.adresBasligi ?? "x-forwarded-for";
+    const guvenilenVekil = s.guvenilenVekil ?? 1;
+    const kaynakKovasi = new AdresKovasi(s.kaynakHizi?.kapasite ?? 5, s.kaynakHizi?.saniyede ?? 5 / 60);
     return async (istek) => {
         const bas = performance.now();
         let kayit = { yontem: istek.method, arac: null, boyut: 0 };
@@ -87,20 +151,17 @@ export function acikMcpIsleyici(s = {}) {
             return bitir(json({
                 hata: "Bu adres bir MCP sunucusudur. Yapay zekâ istemcinize bağlayıcı olarak ekleyin: https://akredit.org/mcp-kullan",
             }, 405, { allow: "POST, OPTIONS" }));
-        const adres = (istek.headers.get(adresBasligi) ?? "").split(",")[0]?.trim() || "bilinmeyen";
+        const adres = istemciAdresi(istek.headers, guvenilenVekil);
         const h = kova.al(adres, simdi().getTime());
         if (!h.izin)
             return bitir(rpcHata(429, -32000, "Çok fazla istek. Biraz bekleyip yeniden deneyin.", { "retry-after": String(h.bekle) }));
-        const uzunluk = Number(istek.headers.get("content-length") ?? "0");
-        if (uzunluk > enBuyuk)
-            return bitir(rpcHata(413, -32600, "İstek çok büyük. Veriyi bölerek gönderin."));
         let metin;
         try {
-            const tampon = await istek.arrayBuffer();
-            kayit.boyut = tampon.byteLength;
-            if (tampon.byteLength > enBuyuk)
+            const g = await govdeOku(istek, enBuyuk);
+            if (g.tur === "buyuk")
                 return bitir(rpcHata(413, -32600, "İstek çok büyük. Veriyi bölerek gönderin."));
-            metin = new TextDecoder().decode(tampon);
+            kayit.boyut = g.tampon.byteLength;
+            metin = new TextDecoder().decode(g.tampon);
         }
         catch {
             return bitir(rpcHata(400, -32700, "İstek okunamadı."));
@@ -113,6 +174,18 @@ export function acikMcpIsleyici(s = {}) {
             return bitir(rpcHata(400, -32700, "İleti JSON değil."));
         }
         kayit = { ...kayit, ...yontemVeArac(govde) };
+        // Dış katalog sorgusu yapan araç için adres başına ayrı, sıkı kota (toplu istekte her çağrı sayılır).
+        const kaynakCagrisi = (Array.isArray(govde) ? govde : [govde]).filter((x) => x &&
+            typeof x === "object" &&
+            x.method === "tools/call" &&
+            x.params?.name === "kaynak_dogrula").length;
+        for (let i = 0; i < kaynakCagrisi; i++) {
+            const k = kaynakKovasi.al(adres, simdi().getTime());
+            if (!k.izin)
+                return bitir(rpcHata(429, -32000, "Kaynak doğrulama için kısa sürede çok fazla istek geldi. Bir dakika bekleyip yeniden deneyin.", {
+                    "retry-after": String(k.bekle),
+                }));
+        }
         const sunucu = acikSunucu({ simdi });
         const tasima = new WebStandardStreamableHTTPServerTransport({
             sessionIdGenerator: undefined,

package/dist/apps/acik-mcp/src/index.d.ts

@@ -1,4 +1,11 @@
 export * from "./araclar.ts";
+export * from "./bologna.ts";
+export * from "./genel-ayristir.ts";
 export * from "./http.ts";
+export * from "./kaynak.ts";
+export * from "./kaynak-dogrula.ts";
 export * from "./kisisel-veri.ts";
+export * from "./not-tablosu.ts";
+export * from "./promptlar.ts";
 export * from "./sunucu.ts";
+export * from "./yardim.ts";

package/dist/apps/acik-mcp/src/index.js

@@ -1,6 +1,13 @@
 // @akredit/acik-mcp: herkese açık, hesapsız, salt okuma MCP sunucusu (İP-49).
 // Kapsam: plan/ip/IP-49-acik-mcp.md
 export * from "./araclar.js";
+export * from "./bologna.js";
+export * from "./genel-ayristir.js";
 export * from "./http.js";
+export * from "./kaynak.js";
+export * from "./kaynak-dogrula.js";
 export * from "./kisisel-veri.js";
+export * from "./not-tablosu.js";
+export * from "./promptlar.js";
 export * from "./sunucu.js";
+export * from "./yardim.js";

package/dist/apps/acik-mcp/src/kaynak-dogrula.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+export declare const IZINLI_HOSTLAR: readonly ["api.crossref.org", "openlibrary.org", "www.googleapis.com"];
+export declare const ZAMAN_ASIMI_MS = 8000;
+export declare const EN_BUYUK_YANIT = 1000000;
+/** Çağrı başına en çok kaynak. */
+export declare const EN_COK_KAYNAK = 5;
+/** Süreç genelinde aynı anda en çok dış istek. */
+export declare const ESZAMANLI_DIS_ISTEK = 4;
+/** Süreç genelindeki dış istek semaforu. Sınır doluysa sıra bekler. */
+export declare function sinirli<T>(is: () => Promise<T>): Promise<T>;
+/** Katalog kaydının imzası: künye ve bağlantı üzerinden HMAC-SHA256 (ilk 32 onaltılık hane). */
+export declare function kaynakImzasi(kunye: string, baglanti: string): string;
+/** İmza bu sürecin kaynak_dogrula çıktısına mı ait? */
+export declare function kaynakImzasiDogru(kunye: string, baglanti: string, imza: string): boolean;
+/** "https://doi.org/10.x/y", "doi:10.x/y" ya da "10.x/y" → "10.x/y". Geçersizse null. */
+export declare function doiTemizle(d: string): string | null;
+/** ISBN-10 ya da ISBN-13; tire ve boşluk atılır, denetim basamağı sınanır. Geçersizse null. */
+export declare function isbnTemizle(i: string): string | null;
+/** Karşılaştırma için sadeleştirme: küçük harf, Türkçe harfler düz, noktalama yok. */
+export declare function sadele(s: string): string[];
+/**
+ * Sorgu başlığının sözcüklerinin en az %80'i bulunan başlıkta var mı, ve bulunanın en az %60'ı sorguda var mı.
+ * Kısa (en çok iki sözcüklü) başlıklarda ("Veri Yapıları", "Genel Kimya") sözcük kümeleri birebir aynı olmalı.
+ */
+export declare function baslikEslesir(sorgu: string, bulunan: string): boolean;
+/**
+ * Sorgudaki yazar soyadı (son sözcük ya da virgülden önceki kısım) bulunan yazarlardan birinde TAM belirteç olarak
+ * geçiyor mu. Alt dize yetmez: "Yılmaz" sorgusu "Yılmazer" ile eşleşmez.
+ */
+export declare function yazarEslesir(sorgu: string, yazarlar: string[]): boolean;
+/** Yanıt gövdesini bayt sayarak okur; sınır aşılırsa akışı iptal edip null döner. */
+export declare function sinirliMetin(y: Response, enBuyuk: number): Promise<string | null>;
+export type KayitTuru = "kitap" | "makale" | "kitap_bolumu" | "diger";
+export interface Dogrulanmis {
+    durum: "katalogda_bulundu";
+    kunye: string;
+    eksikler: string[];
+    baglanti: string;
+    katalog: "Crossref" | "Open Library" | "Google Books";
+    kayitTuru: KayitTuru;
+    baslik: string;
+    yazarlar: string[];
+    yil?: number | string;
+    /** Neyle eşleşti: DOI, ISBN ya da başlık + tam soyad (+ yıl, tür). */
+    kimlik_eslesmesi: {
+        yontem: "doi" | "isbn" | "baslik_yazar";
+        denetlenen: string[];
+    };
+    /** Künyede eksik alan var mı (yayınevi, yıl...). Eksik alan [EKSİK] kalır. */
+    bibliyografik_tamlik: "tam" | "eksik";
+    /** Katalogda bulunmak, ders kaynağı olarak uygun olmak demek değildir. */
+    ders_kaynagi_uygunlugu: "hoca karar verir";
+    /** Bologna araçlarında doğrulanmış kaynak kanıtı. */
+    imza: string;
+}
+export interface Dogrulanamadi {
+    durum: "bulunamadi";
+    neden: string;
+    /** Hoca eseri kendisi biliyorsa yalnız "hoca_beyani" etiketiyle yazılabilir. */
+    hocaBeyani: string;
+}
+export type DogrulamaSonucu = Dogrulanmis | Dogrulanamadi;
+declare const KaynakSorgusu: z.ZodObject<{
+    doi: z.ZodOptional<z.ZodString>;
+    isbn: z.ZodOptional<z.ZodString>;
+    baslik: z.ZodOptional<z.ZodString>;
+    yazar: z.ZodOptional<z.ZodString>;
+    tur: z.ZodOptional<z.ZodEnum<{
+        kitap: "kitap";
+        makale: "makale";
+        kitap_bolumu: "kitap_bolumu";
+        herhangi: "herhangi";
+    }>>;
+    yil: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type KaynakSorgusuT = z.infer<typeof KaynakSorgusu>;
+/** Tek kaynağı doğrular. DOI önce, sonra ISBN, sonra başlık+yazar. */
+export declare function kaynakDogrula(f: typeof fetch, k: KaynakSorgusuT): Promise<DogrulamaSonucu>;
+export declare const kaynakDogrulaAraci: import("./temel.ts").AcikArac<z.ZodObject<{
+    kaynaklar: z.ZodArray<z.ZodObject<{
+        doi: z.ZodOptional<z.ZodString>;
+        isbn: z.ZodOptional<z.ZodString>;
+        baslik: z.ZodOptional<z.ZodString>;
+        yazar: z.ZodOptional<z.ZodString>;
+        tur: z.ZodOptional<z.ZodEnum<{
+            kitap: "kitap";
+            makale: "makale";
+            kitap_bolumu: "kitap_bolumu";
+            herhangi: "herhangi";
+        }>>;
+        yil: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export {};