README
¶
Research Assistant
A variant-aware MCP server that manages context budget by providing the same research tools (search_papers, get_paper, summarize) at different verbosity levels.
Each tool sends progress notifications and log messages as it works, simulating a deep-research workflow where the client can observe each step (e.g. "Searching arXiv", "Resolving references", "Generating summary").
Patterns demonstrated: Context budget management with description verbosity control, notification streaming.
Variants
| Variant | Verbosity | Status | Use Case |
|---|---|---|---|
deep-research |
Multi-paragraph with usage examples | Stable | Literature reviews, large context windows |
quick-lookup |
Single-sentence descriptions | Stable | Fast Q&A, limited token budgets |
synthesis |
Balanced, moderate detail | Experimental | Report generation workflows |
All three variants expose the same three tools with the same behavior — only the description detail level differs.
Custom Ranking
Clients send a "contextSize" hint ("verbose", "compact", or "standard"). The ranking function matches the hint to the appropriate variant, falling back to priority order.
Run
go run ./examples/server/research
The server listens on http://localhost:8080.
Documentation
¶
Overview ¶
Example: Research Assistant — context budget management with the same tools at different verbosity levels. Demonstrates how variants can optimize tool descriptions for different context window sizes and use cases.
Each tool sends progress notifications and log messages as it works, simulating a deep-research workflow where the client can observe each step (e.g. "Searching arXiv", "Resolving references").
Capability demonstrated: Context budget management, description verbosity, notification streaming.
Variants:
- deep-research: Verbose multi-paragraph descriptions with usage examples
- quick-lookup: Concise 1-sentence descriptions for fast Q&A
- synthesis: Balanced descriptions for report generation
Run:
go run ./examples/server/research
Then connect any MCP client to http://localhost:8080.
Source Files