@pipeworx/mcp-gnews 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pipeworx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# mcp-gnews
+
+GNews MCP — Global news search via GNews API (gnews.io)
+
+Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 965+ live data sources.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+
+## Quick Start
+
+Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
+
+```json
+{
+  "mcpServers": {
+    "gnews": {
+      "url": "https://gateway.pipeworx.io/gnews/mcp"
+    }
+  }
+}
+```
+
+Or connect to the full Pipeworx gateway for access to all 965+ data sources:
+
+```json
+{
+  "mcpServers": {
+    "pipeworx": {
+      "url": "https://gateway.pipeworx.io/mcp"
+    }
+  }
+}
+```
+
+## Using with ask_pipeworx
+
+Instead of calling tools directly, you can ask questions in plain English:
+
+```
+ask_pipeworx({ question: "your question about Gnews data" })
+```
+
+The gateway picks the right tool and fills the arguments automatically.
+
+## More
+
+- [All tools and guides](https://github.com/pipeworx-io/examples)
+- [pipeworx.io](https://pipeworx.io)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@pipeworx/mcp-gnews",
+  "version": "0.1.0",
+  "description": "GNews MCP — Global news search via GNews API (gnews.io)",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "gnews"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pipeworx-io/mcp-gnews"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}

package/server.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.pipeworx-io/gnews",
+  "title": "Gnews",
+  "description": "GNews MCP — Global news search via GNews API (gnews.io)",
+  "version": "0.1.0",
+  "websiteUrl": "https://pipeworx.io/packs/gnews",
+  "repository": {
+    "url": "https://github.com/pipeworx-io/mcp-gnews",
+    "source": "github"
+  },
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://gateway.pipeworx.io/gnews/mcp"
+    }
+  ]
+}

package/src/index.ts

@@ -0,0 +1,178 @@
+interface McpToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+  };
+}
+
+interface McpToolExport {
+  tools: McpToolDefinition[];
+  callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+  meter?: { credits: number };
+  cost?: Record<string, unknown>;
+  provider?: string;
+}
+
+/**
+ * GNews MCP — Global news search via GNews API (gnews.io)
+ *
+ * BYO key: requires a free GNews API key from https://gnews.io
+ * Passed via _apiKey parameter. Free tier: 100 requests/day.
+ *
+ * Tools:
+ * - search_news: search news articles by keyword
+ * - top_headlines: get top headlines by category and country
+ */
+
+
+const BASE = 'https://gnews.io/api/v4';
+
+// ── Helpers ───────────────────────────────────────────────────────────
+
+function extractKey(args: Record<string, unknown>): string {
+  const key = args._apiKey as string;
+  delete args._apiKey;
+  if (!key) throw new Error('GNews API key required. Get one free at https://gnews.io and pass via _apiKey.');
+  return key;
+}
+
+async function gnewsGet(apiKey: string, path: string, params: Record<string, string>): Promise<unknown> {
+  const url = new URL(`${BASE}/${path}`);
+  for (const [k, v] of Object.entries(params)) {
+    url.searchParams.set(k, v);
+  }
+  url.searchParams.set('apikey', apiKey);
+
+  const res = await fetch(url.toString());
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`GNews API error (${res.status}): ${text}`);
+  }
+  return res.json();
+}
+
+// ── Types ─────────────────────────────────────────────────────────────
+
+type GNewsArticle = {
+  title?: string | null;
+  description?: string | null;
+  content?: string | null;
+  url?: string | null;
+  image?: string | null;
+  publishedAt?: string | null;
+  source?: { name?: string | null; url?: string | null } | null;
+};
+
+type GNewsResponse = {
+  totalArticles?: number;
+  articles: GNewsArticle[];
+};
+
+function formatArticle(a: GNewsArticle) {
+  return {
+    title: a.title ?? null,
+    description: a.description ?? null,
+    content: a.content ?? null,
+    url: a.url ?? null,
+    image: a.image ?? null,
+    published_at: a.publishedAt ?? null,
+    source_name: a.source?.name ?? null,
+    source_url: a.source?.url ?? null,
+  };
+}
+
+// ── Tool definitions ──────────────────────────────────────────────────
+
+const tools: McpToolExport['tools'] = [
+  {
+    name: 'search_news',
+    description:
+      'Search global news articles by keyword (e.g., "climate change", "AI regulation"). Returns title, description, content snippet, source, and publication date. Supports language and country filters.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        _apiKey: { type: 'string', description: 'GNews API key' },
+        query: { type: 'string', description: 'Search keywords (e.g., "electric vehicles")' },
+        lang: { type: 'string', description: 'Language code (e.g., "en", "fr", "de"). Default: "en"' },
+        country: { type: 'string', description: 'Country code (e.g., "us", "gb", "ca"). Omit for global' },
+        max: { type: 'number', description: 'Max articles to return (1-100, default 10)' },
+      },
+      required: ['_apiKey', 'query'],
+    },
+  },
+  {
+    name: 'top_headlines',
+    description:
+      'Fetch current top news headlines from GNews (requires BYO API key). Optionally filter by category (general, world, nation, business, technology, entertainment, sports, science, health), country code, and language. Returns up to 100 articles with title, description, source, and publication date.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        _apiKey: { type: 'string', description: 'GNews API key' },
+        category: {
+          type: 'string',
+          description: 'News category: general, world, nation, business, technology, entertainment, sports, science, health',
+        },
+        country: { type: 'string', description: 'Country code (e.g., "us", "gb"). Omit for global' },
+        lang: { type: 'string', description: 'Language code (e.g., "en"). Default: "en"' },
+        max: { type: 'number', description: 'Max articles to return (1-100, default 10)' },
+      },
+      required: ['_apiKey'],
+    },
+  },
+];
+
+// ── callTool dispatcher ───────────────────────────────────────────────
+
+async function callTool(name: string, args: Record<string, unknown>): Promise<unknown> {
+  const key = extractKey(args);
+
+  switch (name) {
+    case 'search_news':
+      return searchNews(key, args);
+    case 'top_headlines':
+      return topHeadlines(key, args);
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+// ── Tool implementations ─────────────────────────────────────────────
+
+async function searchNews(apiKey: string, args: Record<string, unknown>) {
+  const params: Record<string, string> = {
+    q: args.query as string,
+    lang: (args.lang as string) ?? 'en',
+    max: String(Math.min(100, Math.max(1, (args.max as number) ?? 10))),
+  };
+  if (args.country) params.country = args.country as string;
+
+  const data = (await gnewsGet(apiKey, 'search', params)) as GNewsResponse;
+
+  return {
+    total_articles: data.totalArticles ?? data.articles.length,
+    returned: data.articles.length,
+    articles: data.articles.map(formatArticle),
+  };
+}
+
+async function topHeadlines(apiKey: string, args: Record<string, unknown>) {
+  const params: Record<string, string> = {
+    lang: (args.lang as string) ?? 'en',
+    max: String(Math.min(100, Math.max(1, (args.max as number) ?? 10))),
+  };
+  if (args.category) params.category = args.category as string;
+  if (args.country) params.country = args.country as string;
+
+  const data = (await gnewsGet(apiKey, 'top-headlines', params)) as GNewsResponse;
+
+  return {
+    total_articles: data.totalArticles ?? data.articles.length,
+    returned: data.articles.length,
+    articles: data.articles.map(formatArticle),
+  };
+}
+
+export default { tools, callTool, meter: { credits: 5 } } satisfies McpToolExport;

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true
+  },
+  "include": ["src"]
+}