SourceHarbor MCP

ComunidadIncomplete39/100Reclamar

pypi sourceharborstdioMITupdated 3mo ago

|---| | 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. |

Código Web2

¿Qué puedes hacer con SourceHarbor MCP?

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.

Instalación

Añade SourceHarbor MCP a tu cliente. Elige el que uses.

claude mcp add sourceharbor -- uvx sourceharbor

codex mcp add sourceharbor -- uvx sourceharbor

amp mcp add sourceharbor -- uvx sourceharbor

{
  "mcpServers": {
    "sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"sourceharbor","command":"uvx","args":["sourceharbor"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "sourceharbor": {
      "command": "uvx",
      "args": [
        "sourceharbor"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "sourceharbor": {
      "type": "local",
      "command": "uvx",
      "args": [
        "sourceharbor"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "sourceharbor": {
      "command": {
        "path": "uvx",
        "args": [
          "sourceharbor"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

uvx sourceharbor

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.