freshcontext-mcp 0.1.0

package/src/tools/freshnessStamp.ts

@@ -0,0 +1,33 @@
+import { FreshContext, AdapterResult, ExtractOptions } from "../types.js";
+
+export function stampFreshness(
+  result: AdapterResult,
+  options: ExtractOptions,
+  adapter: string
+): FreshContext {
+  return {
+    content: result.raw.slice(0, options.maxLength ?? 8000),
+    source_url: options.url,
+    content_date: result.content_date,
+    retrieved_at: new Date().toISOString(),
+    freshness_confidence: result.freshness_confidence,
+    adapter,
+  };
+}
+
+export function formatForLLM(ctx: FreshContext): string {
+  const dateInfo = ctx.content_date
+    ? `Published: ${ctx.content_date}`
+    : "Publish date: unknown";
+
+  return [
+    `[FRESHCONTEXT]`,
+    `Source: ${ctx.source_url}`,
+    `${dateInfo}`,
+    `Retrieved: ${ctx.retrieved_at}`,
+    `Confidence: ${ctx.freshness_confidence}`,
+    `---`,
+    ctx.content,
+    `[/FRESHCONTEXT]`,
+  ].join("\n");
+}

package/src/types.ts

@@ -0,0 +1,22 @@
+// Core data types for freshcontext-mcp
+
+export interface FreshContext {
+  content: string;
+  source_url: string;
+  content_date: string | null;   // When the content was originally published
+  retrieved_at: string;           // When WE fetched it (always now)
+  freshness_confidence: "high" | "medium" | "low";
+  adapter: string;
+}
+
+export interface ExtractOptions {
+  url: string;
+  prompt?: string;        // What specifically to look for
+  maxLength?: number;     // Truncate content to this length
+}
+
+export interface AdapterResult {
+  raw: string;
+  content_date: string | null;
+  freshness_confidence: "high" | "medium" | "low";
+}

package/start-server.bat

@@ -0,0 +1,2 @@
+@echo off
+"C:\Program Files\nodejs\npx.cmd" tsx "C:\Users\Immanuel Gabriel\Downloads\freshcontext-mcp\src\server.ts"

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}