[Integration] RapierCraft/Perplexity-Comet-MCP - optional You.com search integration

[mouse-value-add]

Source repo: https://github.com/RapierCraft/Perplexity-Comet-MCP

Why selected

• Active TypeScript MCP server with a focused browser/research use case.
• A search-backed fallback fits the project’s agentic browsing workflow without changing defaults.
• The codebase is small enough for a reviewable, optional addition.

Candidate evaluation

• RapierCraft/Perplexity-Comet-MCP: best fit today, 48 stars, recent activity, clear MCP tool surface, and a low-risk opt-in path.
• sfr-development/WonderSuite-Ai-Bug-Bounty: active and search could help, but the repo is broader and heavier, so the integration path is less clean.
• WangHuiNEU/open-science-toolkit: active, but far below the preferred star range and too sprawling for a small reviewable change.

Integration type

• Optional MCP tool backed by You.com Search API.

Setup / env vars

• YDC_API_KEY enables the optional youcom_search tool.
• If unset, existing Comet MCP behavior stays unchanged.

Expected usage example

• youcom_search {"query":"latest playwright locator guidance","count":5}

Validation plan

• npm run build
• npm run test:unit
• Confirm default Comet behavior is unchanged when YDC_API_KEY is absent.

Validation results

• npm install
• npm run build
• npm run test:unit

Fallback / error behavior

• Missing YDC_API_KEY keeps the tool unavailable or returns a clear setup error, depending on entrypoint.
• Upstream HTTP failures surface status and message without crashing the MCP server.

Links

• Implementation branch: https://github.com/mouse-value-add/Perplexity-Comet-MCP/tree/feat/youcom-search-integration
• OSS PR: feat: add optional You.com search tool RapierCraft/Perplexity-Comet-MCP#38

Current status

• PR open, no review comments or requested changes yet.

[mouse-value-add]

Selected repo: https://github.com/RapierCraft/Perplexity-Comet-MCP
Implementation branch: https://github.com/mouse-value-add/Perplexity-Comet-MCP/tree/feat/youcom-search-integration
OSS PR: RapierCraft/Perplexity-Comet-MCP#38

Integration type

• Optional MCP tool plus HTTP bridge parity, backed by You.com Search API.

Setup / env vars

• YDC_API_KEY enables youcom_search.
• No change when the env var is unset.

Usage example

• youcom_search {"query":"playwright locator best practices","count":5}

Fallback / error behavior

• Missing YDC_API_KEY returns a clear setup error.
• Upstream HTTP failures surface the status and message.

Validation

• npm install
• npm run build
• npm run test:unit -- tests/unit/youcom.test.ts

Status

• Branch pushed and PR opened.