🚀 femtech-radar

FemTech intelligence as a GitHub-native, agent-driven pipeline

Agent-first FemTech intelligence: an MCP server that fetches, dedupes, and scores women's-health & FemTech research and industry news, designed to feed GitHub Agentic Workflows and an auto-updating Astro + RSS site.

Live Demo · Documentation · Changelog · Report Bug · Request Feature

• 🌟 Introduction

• ✨ Key Features

• 🛠️ Tech Stack

• 🏗️ Architecture

• 🚀 Getting Started

• 🛳 Project Status & Roadmap

• 📖 Usage Guide

• ⌨️ Development

• 🤝 Contributing

• ❤️ Sponsor

• 📄 License

• 🙋‍♀️ Author

🌟 Introduction

The FemTech and women's-health world produces a scattered firehose of signal — research preprints, funding and product news, community opportunities, technical discussion — across dozens of sources. femtech-radar turns that noise into a curated, deduplicated, ranked digest, using only GitHub-native primitives plus a reusable Model Context Protocol (MCP) server.

It's a complete, live three-unit pipeline — scrape → curate → publish:

1. an MCP server (the deterministic "brain") fetches from multiple sources, normalizes into one shape, dedupes, and scores each item by relevance × popularity × freshness, exposing the result over MCP;

2. a weekly GitHub Agentic Workflow (gh aw) drives the MCP, lets Copilot curate the digest, and commits the week's data/*.json via a review-gated PR;

3. an Astro + RSS site reads that data and auto-deploys to GitHub Pages.

It's built for FemTech / women-in-tech practitioners who want signal without the noise — and as a reference implementation of the gh aw × MCP × GitHub Pages pattern. The product is live: a subscribable weekly intelligence site at https://chanmeng666.github.io/femtech-radar/ that updates itself for free on a public GitHub repo.

Related MCP server: junk-filter-mcp

✨ Key Features

1 One MCP tool, a whole radar — radar_collect returns normalized, deduped, scored items per section. v1 ships industry (Google News) and research (arXiv); opportunities and discussions are defined and roadmapped.

2 Deterministic, testable core — fetch → normalize → dedupe → score. The server makes no editorial judgment; that's left to the agent that drives it. 28 unit tests, and zero real network calls in tests (all I/O is injected).

3 Pluggable source adapters — each source is one file behind a uniform Adapter interface. Add a feed by writing a collect() that returns RadarItem[].

4 Resilient by construction — every source failure degrades to an empty result plus a warning; a malformed URL or date never throws out of a run.

5 GitHub-native, near-zero cost — designed to run inside GitHub Actions on a public repo, where Actions and Pages are free; the only metered resource is a few Copilot credits per week.

6 Reusable anywhere MCP runs — drop it into Claude Desktop or any MCP client; it isn't coupled to this project.

7 Live, self-updating, subscribable — a weekly gh aw workflow curates the digest into a review-gated data/*.json PR, and an Astro + RSS site rebuilds itself on GitHub Pages. Readers subscribe via RSS — no manual scraping, no server to run.

🛠️ Tech Stack

• Language / Runtime: TypeScript 5 (strict, ESM) · Node.js ≥ 20

• MCP: @modelcontextprotocol/sdk (stdio server)

• Parsing / validation: Zod (schema & runtime validation) · fast-xml-parser (Atom/RSS)

• Tooling: pnpm workspaces (monorepo) · Vitest (tests) · tsup (build)

• Orchestration: GitHub Agentic Workflows (gh aw) · engine copilot, model gpt-4.1 · weekly schedule → review-gated data PR

• Site: Astro 5 (femtech-radar-site) · @astrojs/rss · GitHub Pages deploy via deploy-pages.yml

🏗️ Architecture

graph TD
    subgraph Sources
      A1[arXiv API]
      A2[Google News RSS]
    end
    A1 --> AD[Source adapters<br/>normalize → RadarItem]
    A2 --> AD
    AD --> P["collect()<br/>dedupe → score → sort → since-filter"]
    P --> T[MCP tools<br/>radar_collect · radar_sources]
    T --> C[MCP clients]
    C --> W[Weekly gh aw workflow<br/>Copilot curates · writes why_it_matters]
    W --> D[(data/YYYY-Www.json<br/>review-gated PR)]
    D --> S[Astro + RSS site<br/>GitHub Pages · live]

All three units are built and live. The diagram shows the full scrape → curate → publish pipeline.

Separation of determinism vs judgment: the MCP server does only deterministic work (fetch, normalize, dedupe, score). Editorial choices — which items to feature, how to summarize — belong to the agent (gh aw + Copilot) that drives it. This keeps the core unit-testable and reusable.

🚀 Getting Started

Prerequisites

• Node.js ≥ 20 (the server uses global fetch)

• pnpm ≥ 9 (npm i -g pnpm)

• (optional) an MCP client such as Claude Desktop, or the gh aw CLI

Installation

git clone https://github.com/ChanMeng666/femtech-radar.git
cd femtech-radar
pnpm install

# Build the MCP server
pnpm --filter @chanmeng666/femtech-radar-mcp build

# Run the test suite (28 tests)
pnpm --filter @chanmeng666/femtech-radar-mcp test

The built server is an executable stdio MCP server at packages/mcp-server/dist/index.js. It's also published to npm, so any MCP client can run it with npx -y @chanmeng666/femtech-radar-mcp.

Run the site locally

# Dev server (reads data/*.json)
pnpm --filter femtech-radar-site dev

# Production build + preview
pnpm --filter femtech-radar-site build
pnpm --filter femtech-radar-site preview

The published site is live at https://chanmeng666.github.io/femtech-radar/ (RSS: /rss.xml); it rebuilds automatically whenever a new weekly data/*.json lands on master.

🛳 Project Status & Roadmap

All three planned layers are built and live in production (see docs/superpowers/specs for the full design and docs/superpowers/plans for the per-unit implementation plans):

• ✅ v1 — MCP server: industry (Google News) + research (arXiv) adapters, dedupe/score pipeline, radar_collect / radar_sources tools, resilient error handling, 28 tests. Published to npm as @chanmeng666/femtech-radar-mcp.

• ✅ v2 — orchestration: a weekly gh aw workflow (engine copilot, model gpt-4.1) that drives the MCP, curates a digest, and emits a review-gated data PR plus a summary issue — proven end-to-end in production (first digest: data/2026-W27.json).

• ✅ v3 — publishing (live): Astro 5 site auto-deployed to GitHub Pages at https://chanmeng666.github.io/femtech-radar/ with a subscribable RSS feed at https://chanmeng666.github.io/femtech-radar/rss.xml; rebuilds automatically on every weekly data update.

Deferred to a future version (not yet built): the opportunities + discussions source adapters, ChatOps slash commands (/deep-dive), per-section RSS feeds, and full bilingual (i18n routing is reserved).

📖 Usage Guide

femtech-radar is consumed as an MCP server. It exposes two tools:

In v1 only industry and research have adapters; opportunities and discussions return an empty list with a "no adapter for …" warning.

Subscribe via RSS: the weekly digest is published at https://chanmeng666.github.io/femtech-radar/rss.xml and works in any feed reader.

Use with GitHub Agentic Workflows (gh aw)

mcp-servers:
  femtech-radar:
    command: npx
    args: ["-y", "@chanmeng666/femtech-radar-mcp"]

Use with Claude Desktop

{
  "mcpServers": {
    "femtech-radar": {
      "command": "node",
      "args": ["/absolute/path/to/femtech-radar/packages/mcp-server/dist/index.js"]
    }
  }
}

npx @chanmeng666/femtech-radar-mcp works once the package is published to npm (v2). Until then, build locally and point your client at dist/index.js as shown above.

See packages/mcp-server/README.md for the full tool reference.

⌨️ Development

pnpm install                                              # install workspace deps
pnpm --filter @chanmeng666/femtech-radar-mcp test         # run tests (Vitest)
pnpm --filter @chanmeng666/femtech-radar-mcp build        # build with tsup

Project layout

packages/mcp-server/src/
├── schema.ts          # Zod RadarItem / WeeklyData (the shared data contract)
├── dedup.ts           # URL canonicalization + title-similarity dedupe
├── score.ts           # relevance × popularity × freshness scoring
├── adapters/          # one file per source (research = arXiv, industry = Google News)
├── collect.ts         # orchestration: adapter → dedupe → score → sort → since-filter
├── tools.ts           # radar_collect / radar_sources handlers
└── index.ts           # stdio MCP server entry

Adding a source adapter: implement the Adapter interface in adapters/, return RadarItem[] from collect(opts) using the injected fetcher (never call fetch directly — that keeps it testable), then wire it into ADAPTERS in collect.ts.

See AGENTS.md for AI-agent-oriented project conventions and gotchas.

🤝 Contributing

Contributions make the open-source community an amazing place to learn and create. Please read the Contributing Guide and the Code of Conduct before you start, and use the provided issue / pull-request templates.

❤️ Sponsor

If this project helps you, please consider supporting its development:

For questions and help, see SUPPORT.md. For security issues, see SECURITY.md.

📄 License

This project is released under the MIT license.

🙋‍♀️ Author

Chan Meng