SourceHarbor MCP

Name: SourceHarbor MCP
Author: xiaojiou176-open

Local

github.com/xiaojiou176-openProductivity2Updated 22w ago

Repository

About SourceHarbor MCP

SourceHarbor MCP is presented as a source-first knowledge control tower for YouTube, Bilibili, RSSHub, and RSS. The supplied README describes BrewMe, a local-first news desk that gathers and ranks feeds, web sources, podcasts, papers, and GitHub items for personal briefings.

Key features

01Ingest RSS, web, podcasts, papers, and GitHub
02Rank items by personal interests
03Summarize news into briefings
04Provide web, terminal, and binary entry points
05Run fetch, ranking, and briefing services with Docker Compose

Use cases

01Prepare a personalized morning news briefing
02Collect updates from RSS and web sources
03Review ranked items from podcasts, papers, and GitHub

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "xiaojiou176-open-sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ],
      "env": {
        "SOURCE_HARBOR_API_BASE_URL": "<SOURCE_HARBOR_API_BASE_URL>"
      }
    }
  }
}

Run commanduvx sourceharbor

Environment variables to set

SOURCE_HARBOR_API_BASE_URLBase URL for a running SourceHarbor API.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypisourceharbor0.1.14stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required
id	any	No
ids	any	No
tags	any	No
action	string	Yes
enabled	boolean	No
category	any	No
platform	any	No
priority	any	No
source_url	any	No
source_type	any	No
adapter_type	any	No
enabled_only	any	No
rsshub_route	any	No
source_value	any	No

Details

From the project README

hot beverage

BrewMe

wake up, news already brewed

What You Get • Install • How It Work • Ecosystem

BrewMe is your morning news desk in a box. RSS, web, podcasts, papers, GitHub — all in, ranked by what you care about, served the moment your alarm rings.

┌──────────────────────────────────────┐
│  LOCAL-FIRST          ████████ 100%  │
│  SOURCE-TRACEABLE     ████████ 100%  │
│  TYPING REQUIRED      ░░░░░░░░   0%  │
│  VIBES                ████████ ZERO  │
│                                FILLER│
└──────────────────────────────────────┘

Personal news brewer. Ingest, weigh, summarize. Caffeine-grade signal-to-noise.

What You Get

Surface	What
`brewme apps`	Web, terminal, and bin entry points. Same brew, different cup.
`packages & starter-packs`	Everything you need to brew your own beat.
`contracts`	Source schemas, weighing schemas, brief schemas. All versioned.
`infra`	One Docker compose. Cron, fetcher, ranker, brewer, server.
`evals`	Prove the brew is better than yesterday.

Important

Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.

Install

git clone https://github.com/xiaojiou176-open/BrewMe.git
cd BrewMe
# follow the per-stack quickstart in INSTALL.md or docs/

Three commands. No curl | sh. No login. Read what you run.

Install break? Open your favorite agent and say "Read AGENTS.md and bootstrap BrewMe for me." Agent fix own brain. Long version: docs/.

How It Work

The repo is seven layers — exactly the seven commits in git log. New work goes in as small named PRs. No 50-file mystery commits.

Layer	What
`chore: scaffold`	License, governance, hygiene gates, CI scaffolding.
`feat(core)`	The primary engine. The reason BrewMe exists.
`feat(modules)`	Packages, adapters, services, plugins. The second floor.
`feat(contracts)`	Schemas, configs, public boundaries. Other code talks here.
`test:`	Receipts. Everything in this layer must run.
`feat(ops)`	Scripts, infra, CI helpers, build glue.
`docs:`	Public docs surface. The pretty face.

git log reads like a building floor plan. Look once, know the whole shape.

Ecosystem

BrewMe lives in the *Me family: three personal tools. command-style names, stupid-simple jobs.

Repo	What
BeamMe	beam your agent config to any planet
BrewMe (you here)	wake up, news already brewed
AgentGangGang	five AIs in one sidebar

Cross-family taste: BeamMe · BrewMe · OpenVibeCoding · proofyard.

Star This Repo

If BrewMe saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐

Also by Yifeng[Terry] Yu

BeamMe — beam your agent config to any planet
AgentGangGang — five AIs in one sidebar
OpenVibeCoding — AI codes overnight, you ship in the morning
proofyard — every claim ships with its receipt
dealyard — let prices fight, you sit and watch

License

MIT — small print, big freedom.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.