Skip to content

docs: add an opt-in stdio bridge example for web research - #36

Closed
georgeatparallel wants to merge 3 commits into
he-yufeng:mainfrom
georgeatparallel:parallel-search-4194f897-be64-4af2-95e5-978591d43912
Closed

georgeatparallel wants to merge 3 commits into
he-yufeng:mainfrom
georgeatparallel:parallel-search-4194f897-be64-4af2-95e5-978591d43912

Conversation

@georgeatparallel

Copy link
Copy Markdown

Adds an opt-in web research example through CoreCoder's existing stdio MCP loader. The example uses a pinned mcp-remote bridge to reach Parallel Search MCP over Streamable HTTP, with a CoreCoder User-Agent and support for existing network proxy settings.

The setup guide covers Node.js, warming the bridge cache before the 15-second startup timeout, merging the entry into ~/.corecoder/mcp.json, consent and plan mode, one-shot use, and removal. The endpoint is free for light use and needs no Parallel API key. The model still uses the user's existing configuration. Both READMEs link to the example.

Validation:

  • 215 tests passed; upstream CI lint scope and compileall passed.
  • The installed CLI loaded the exact example in an isolated home. A controlled streaming model fixture drove live anonymous search and fetch calls, returning useful Python TaskGroup documentation and a sourced summary.
  • Observed the CoreCoder User-Agent and absence of Authorization on tool discovery, search, and fetch requests. Checked that no configuration retains eight built-in tools and that one-shot mode refuses MCP calls without consent.

The streaming fixture verifies the caller and returned content, rather than autonomous model quality. Unscoped ruff check also reports an existing EXE001 on the unchanged examples/plan_hooks_demo.py; ruff check corecoder tests matches CI and passes.

I work at Parallel. Prepared with AI assistance.

@he-yufeng

Copy link
Copy Markdown
Owner

Thanks for the careful writeup, and for validating against the live loader.

I'm going to pass on this one though. CoreCoder's docs stay vendor neutral: the examples directory only ships configurations for tools I maintain and can verify over time, and a pinned bridge to a specific commercial search endpoint isn't something I can keep current or stand behind in the README. The stdio MCP loader already covers the general mechanism, so anyone who wants this exact setup can wire it up from your branch in a few minutes.

Closing unmerged, but the consent/plan-mode notes in the guide were a good read.

@he-yufeng he-yufeng closed this Oct 7, 2026
he-yufeng added a commit that referenced this pull request Oct 7, 2026
examples/mcp_filesystem.{json,md}: the MCP org's reference filesystem
server scoped to one directory, merged into ~/.corecoder/mcp.json, with
the warm-cache and /mcp reconnect notes from real first-run behavior.
Both READMEs link it from the MCP section. A pin test keeps every
examples/*.json loadable against the mcp.py config contract.

Prompted by #36: the demand for a ready-made MCP wiring example is real,
but the docs stay vendor neutral, so this ships the reference server
instead of a specific commercial endpoint.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants