Welcome to the 🌸 Spring Into Haystack 🌸 your chance to cultivate something useful, elegant, and powerful — just like spring itself! 🌼
Your mission is to build a tool-using Haystack Agent that acts as an MCP Client and connects to the GitHub MCP Server. Once connected, your Agent will be able to call GitHub tools — all through the power of the Model Context Protocol.
To get started, check out the scaffolded starter code in github-agent.py. You’ll need to:
- Implement the missing parts
- Configure your Agent to connect to the GitHub MCP server
- Make sure the Agent can reason and act based on tool outputs
Note: The official GitHub MCP Server requires Docker to run. If you're unable to use Docker (e.g. due to system limitations or permissions), you can use the legacy GitHub MCP Server, which is deprecated but can be run easily run with
npx. Note that the set of available tools differs between the official and legacy servers.
✅ Test Your Agent: Find the Hidden Typo
To verify your Agent is working correctly, we’ve planted a typo somewhere in this very README.
Once your Agent is fully wired up and reasoning correctly, it should:
- Detect the typo by reading this README via the GitHub MCP server
- Open a GitHub issue describing the typo clearly in the issue body
This will prove that your Agent can:
- Understand the task and make a plan
- Select the right tool(s) from the GitHub MCP server
- Execute an action on GitHub
- Fork this repo on GitHub
- Fill in the missing peices in
github-agent.pyto build your MCP-connected Agent - Push your code to your forked repo
- Submit the link to the repo so we can see your creation in full bloom!
For more info, check out Spring Into Haystack webpage.
- A GitHub Token with relevant permissions
pip install -r requirements.txt
Note: The
mcp-haystackpackage requires Python ≥ 3.10