Spring Into Haystack

What is Spring Into Haystack

Spring Into Haystack is a project aimed at building a tool-using Haystack Agent that acts as an MCP Client, connecting to the GitHub MCP Server to utilize various GitHub tools through the Model Context Protocol.

Use cases

Use cases include automating issue creation for detected typos, enhancing development workflows, and building intelligent agents that can interact with GitHub repositories.

How to use

To use Spring Into Haystack, you need to fork the repository, implement the missing parts in the provided starter code, configure your Agent to connect to the GitHub MCP server, and ensure it can reason and act based on tool outputs.

Key features

Key features include the ability to connect to the GitHub MCP server, utilize GitHub tools, reason based on outputs, and perform actions such as detecting typos and opening GitHub issues.

Where to use

Spring Into Haystack can be used in software development, automation tasks, and any scenario where integration with GitHub tools is required.

Welcome to the 🌸 Spring Into Haystack 🌸 your chance to cultivate something useful, elegant, and powerful — just like spring itself! 🌼

🪻 Your Spring Challenge

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:

1. Detect the typo by reading this README via the GitHub MCP server
2. 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

🌷 Start Building

1. Fork this repo on GitHub
2. Fill in the missing peices in github-agent.py to build your MCP-connected Agent
3. Once you’re done, check out solution.py to compare your implementation.

Requirements:

• A GitHub Token with relevant permissions

Install Dependencies

pip install -r requirements.txt

Note: The mcp-haystack package requires Python ≥ 3.10

Components:

• Agent – component for the smart decision-maker
• MCPTool – lets your agent talk to the MCP Server