learning-react-mcp

• minimal MCP server that pre-scrapes React learning docs into DuckDB
• hybrid search using DuckDB full-text search and transformer-based reranking

Dev

uv sync
uv run main_setup.py
uv run main.py

Test

# initialize request
{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"manual-cli","version":"1.0.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"question":"CSSにについて教えて"}}}
# response -> {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"概要引用符で文字列を渡す 波括弧は JavaScript 世界への窓口 波括弧を使える場所 「ダブル波括弧」で JSX 内に CSS やその他のオブジェクトを含める オブジェクトと波括弧でさらにいろいろやってみる まとめチャレンジ問題"}],"isError":false}}

Setup

• vscode settings.json

"react-learning-mcp":{
  "command": "bash",
  "args": [
    "-c",
    "cd {{REPOSITORY_PATH}} && uv run main.py"
  ]
}

Reference

• https://voluntas.ghost.io/duckdb-hybrid-search/