trackmcp
Back to directory
chin3

multi-agent-research-poc

View on GitHub

This project is a proof of concept for running a local-first multi-agent system using: ๐Ÿค– Local LLMs via Ollama ๐Ÿงฉ Simple function/tool-call detection using <tool_call>... ๐Ÿ” Brave Search API or optional Brave MCP plugin server ๐Ÿง  Two collaborating agents: Searcher and Synthesizer

1 stars PythonAI & Machine Learning Updated Jun 3, 2025

Documentation

๐Ÿง  AutoGen-Compatible Multi-Agent Research POC with Ollama + BraveSearch

This project is a proof of concept for a local-first multi-agent system using:

  • ๐Ÿค– Local LLMs via Ollama
  • ๐Ÿงฉ Tool-call detection using `...` syntax
  • ๐Ÿ” Web search via Brave Search API or Brave MCP plugin server
  • ๐Ÿง  Two collaborating agents: `Searcher` and `Synthesizer`

๐Ÿ“ Folder Structure

bash
MultiResearchPOC/
โ”œโ”€โ”€ main.py                   # Entry point
โ”œโ”€โ”€ agents/
โ”‚   โ”œโ”€โ”€ searcher.py           # Ollama-powered research agent
โ”‚   โ””โ”€โ”€ synthesizer.py        # Summarizer agent
โ”œโ”€โ”€ tools/
โ”‚   โ”œโ”€โ”€ tool_parser.py        # Tool call detection logic
โ”‚   โ””โ”€โ”€ tool_registry.py      # Tool dispatcher (API or MCP)
โ”œโ”€โ”€ .env                      # Contains BRAVE_API_KEY
โ””โ”€โ”€ requirements.txt          # Python dependencies

๐Ÿš€ Getting Started

1. Clone the project

bash
git clone 
cd MultiResearchPOC

2. Install dependencies

bash
pip install -r requirements.txt

3. Set up your `.env`

bash
echo "BRAVE_API_KEY=your_brave_api_key_here" > .env

Get your Brave API key at: https://developer.brave.com/api-search/

4. Run Ollama locally

bash
ollama run llama3:8b

> If using Docker: make sure to reference the host as `http://host.docker.internal:11434`

5. Run the program

bash
python main.py

You should see:

  • A response from the `Searcher` agent
  • A tool call triggered
  • Search results pulled from Brave
  • A final summary from the `Synthesizer` agent

๐Ÿ” Switching Between API and MCP Plugin

Option 1: Brave Search API (default)

Used by default via:

python
"BraveSearch": call_brave_api

Option 2: Brave MCP Plugin Server

1. Start the plugin server:

bash
npx @modelcontextprotocol/server-brave-search

2. Update `tools/tool_registry.py`:

python
# "BraveSearch": call_brave_api,
"BraveSearch": call_brave_mcp_server

๐Ÿ”ฎ Next Steps & Improvements

FeatureDescription
๐Ÿง  Add Planner AgentDynamically decide which agent/tool to call
๐Ÿงฉ Add More ToolsCrunchbaseSearch, TwitterTrends, YouTubeSearch, etc.
๐Ÿ“„ Markdown OutputSave session logs for review or integration with Obsidian
๐Ÿ–ผ๏ธ Add UIUse Chainlit, FastAPI, or Discord bot for interaction
๐ŸŒ Wrap as APIConvert to a local API for web or CLI usage

๐Ÿ“œ Sample Output

text
๐Ÿค– Searcher Response:
BraveSearch({"query": "African AI startups 2024 promising not mainstream"})

๐ŸŒ Tool Output:
โ€ข AI 100: ...
โ€ข Five African AI startups to watch in 2023 ...

๐Ÿง  Final Summary:
- CB Insights lists top private AI companies...
- 5 African startups solving problems in healthcare, marketing...

๐Ÿ™Œ Credits


For questions or ideas, open an issue or start a discussion!

๐Ÿ—๏ธ Built for the Microsoft AI Agents Hackathon

This project was created as part of the Microsoft AI Agents Hackathon โ€” a challenge focused on building intelligent, tool-using, autonomous agents powered by open-source and Microsoft technologies.

The goal of this project is to showcase a local-first, multi-agent system that can:

Generate dynamic tool calls

Perform live web research using Brave Search

Collaborate between agents to synthesize useful insights

๐Ÿ”— Submission: [TBD]

code
local multi-agent AI research bot | Ollama + Brave + AutoGen | Built for Microsoft AI Agents Hackathon

Disclaimer

This project is a personal proof-of-concept developed entirely outside of my employment, using personal time and tools. It is unrelated to any current or anticipated business activities of my employer and contains no proprietary or confidential information.

Frequently asked questions

What is multi-agent-research-poc?

multi-agent-research-poc is This project is a proof of concept for running a local-first multi-agent system using: ๐Ÿค– Local LLMs via Ollama ๐Ÿงฉ Simple function/tool-call detection using <tool_call>... ๐Ÿ” Brave Search API or optional Brave MCP plugin server ๐Ÿง  Two collaborating agents: Searcher and Synthesizer

How do I install multi-agent-research-poc?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is multi-agent-research-poc open source?

Yes โ€” it is hosted on GitHub at https://github.com/chin3/Multi-Agent-Research-POC and has 1 stars.

Related MCP tools

All-Hands-AIopenhands

๐Ÿ™Œ OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

64,677 Python
agentartificial-intelligencechatgpt+6
mem0aimem0

Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.

42,646 Python
agentsaiai-agents+12
zhayujiechatgpt-on-wechat

ๅŸบไบŽๅคงๆจกๅž‹ๆญๅปบ็š„่Šๅคฉๆœบๅ™จไบบ๏ผŒๅŒๆ—ถๆ”ฏๆŒ ๅพฎไฟกๅ…ฌไผ—ๅทใ€ไผไธšๅพฎไฟกๅบ”็”จใ€้ฃžไนฆใ€้’‰้’‰ ็ญ‰ๆŽฅๅ…ฅ๏ผŒๅฏ้€‰ๆ‹ฉChatGPT/Claude/DeepSeek/ๆ–‡ๅฟƒไธ€่จ€/่ฎฏ้ฃžๆ˜Ÿ็ซ/้€šไน‰ๅƒ้—ฎ/ Gemini/GLM-4/Kimi/LinkAI๏ผŒ่ƒฝๅค„็†ๆ–‡ๆœฌใ€่ฏญ้Ÿณๅ’Œๅ›พ็‰‡๏ผŒ่ฎฟ้—ฎๆ“ไฝœ็ณป็ปŸๅ’Œไบ’่”็ฝ‘๏ผŒๆ”ฏๆŒๅŸบไบŽ่‡ชๆœ‰็Ÿฅ่ฏ†ๅบ“่ฟ›่กŒๅฎšๅˆถไผไธšๆ™บ่ƒฝๅฎขๆœใ€‚

39,573 Python
aiai-agentchatgpt+17
assafelovicgpt-researcher

An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to

24,026 Python
agentaiautomation+8
jlowinfastmcp

๐Ÿš€ The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

19,927 Python
agentsfastmcpllms+6
1Panel-devmaxkb

๐Ÿ”ฅ MaxKB is an open-source platform for building enterprise-grade agents. MaxKB ๆ˜ฏๅผบๅคงๆ˜“็”จ็š„ๅผ€ๆบไผไธš็บงๆ™บ่ƒฝไฝ“ๅนณๅฐใ€‚ for the Model Context Protocol. Enhance AI assistants with po

19,062 Python
agentagentic-aichatbot+11

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP