AI-Project-Planner-Agent
Provides web search capabilities via DuckDuckGo, allowing the agent to fetch up-to-date information for research decisions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AI-Project-Planner-Agent I want to build an AI-powered crop disease detection system."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI Project Feasibility & Solution Planner Agent
An MCP-based AI agent that evaluates an AI project idea using structured reasoning stages. The project focuses on reasoning quality, prompt engineering, structured outputs, and clean logs using the Gemini API (optimized for Free Tier).
Screenshots
Related MCP server: Gemini DeepSearch MCP
Architecture
The project consists of a FastMCP server and a client interacting with the Gemini 2.5 Flash model.
Client (
client.py): Prompts the user for a project idea, communicates with the Gemini model, routes tool calls to the MCP server, and formats the output cleanly using theRichlibrary.Server (
server.py): A FastMCP server exposing aresearch_topictool that uses DuckDuckGo Search to fetch up-to-date web information.Models (
models/reasoning_models.py): Pydantic models ensuring structured JSON outputs for all 7 reasoning stages.Reasoning: Evaluates the idea through 7 structured stages:
Problem Understanding
Requirement Analysis
Complexity & Constraint Analysis
Research Decision (Calls MCP tool only if needed)
Technology Recommendation
Risk & Roadmap
Final Report
Folder Structure
s5 - AI Project Planner Agent/
│
├── server.py # FastMCP server exposing the research_topic tool
├── client.py # Main client application handling Gemini interactions
├── prompts/
│ └── system_prompt.md # System prompt guiding the reasoning stages
├── tools/
│ └── research_tool.py # Implementation of web search logic
├── models/
│ └── reasoning_models.py # Pydantic models for structured outputs
├── README.md # Project documentation
└── pyproject.toml # uv configurationInstallation
This project uses uv for lightning-fast dependency management.
# Sync dependencies
uv sync(If initializing from scratch):
uv init
uv add google-genai mcp fastmcp pydantic rich duckduckgo-search python-dotenvEnvironment Variables:
Create a .env file in the root directory and add your Gemini API key (ensure .env is listed in your .gitignore!):
GEMINI_API_KEY="your_api_key_here"Usage
You do not need to run the server separately. The client automatically spawns the MCP server over stdio using uv.
Running the Client
uv run client.pyExample User Prompts
I want to build an AI-powered crop disease detection system.I want to build an AI-powered exam proctoring system.Prompt Evaluation Workflow
The system prompt is isolated in prompts/system_prompt.md. You can freely evaluate and refine the instructions in this file without modifying any application logic. Ensure that changes in the prompt still instruct the model to produce the 7 required reasoning stages matching the Pydantic models. This project is verified against prompt_checker.md for explicit reasoning instructions, internal self-checks, and fallback plans.
Example Logs
Welcome to the AI Project Planner Agent
Enter your project idea: I want to build an AI-powered exam proctoring system.
Connecting to MCP Server...
Reasoning about your project...
Agent decided to research: research_topic(...)
==================================================
Stage – Problem Understanding
Goal
Understand the user's project
Analysis
AI-powered exam monitoring.
Reasoning Summary
Computer vision + authentication.
Reasoning Type
analytical
Self Check
Did I assume the user has access to a webcam? Yes, need to clarify.
Status
Completed
==================================================
... (Repeat for all 7 stages) ...
==================================================
MISSION COMPLETEAvailable Tools
1 toolresearch_topicA
Search the web for information regarding a specific topic.
Use this tool when you need up-to-date information, technical details, or domain knowledge that you don't possess.
Args:
query: The search query.
Returns:
A string containing the search results summarized.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusion between tools. The tool's purpose is clearly defined and distinct.
The single tool name follows a clear verb_noun pattern and is unambiguous. There are no conflicting conventions.
With only one tool, the server is far too thin for the stated purpose of an AI project planner, which would require multiple tools for planning and management.
The server only supports research, leaving out all planning, task management, and workflow tools that would be essential for an AI project planner agent.
Maintenance
Related MCP Connectors
Read-only AI project discovery, verification, comparison, shortlisting, and stack planning.
Test the idea before you build it. Rapidly works inside your AI agent.
Turns vague automation requests into tool stacks, prompts, QA checks, and human boundaries.
Multi-agent AI pipeline that generates professional Solution Architecture Documents.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnhances AI model capabilities with structured, retrieval-augmented thinking processes that enable dynamic thought chains, parallel exploration paths, and recursive refinement cycles for improved reasoning.124MIT
- AlicenseBqualityDmaintenanceAn automated research agent that leverages Google Gemini models and Google Search to perform deep, multi-step web research, generating sophisticated queries and producing citation-rich answers.192 PyPI28MIT
- FlicenseNot gradedqualityCmaintenanceIntegrates Google's Gemini API to provide sequential analytical thinking and problem-solving capabilities with meta-commentary, confidence levels, branching thoughts, and session persistence for complex problems.1-
- FlicenseBqualityDmaintenanceProvides advanced AI reasoning and strategic thinking capabilities using Pollinations AI API with DeepSeek models, plus real-time web search through SearchGPT for comprehensive analysis and research.3-