How to Debug an MCP Server Without Connecting to a Live LLM
At Manufact we gave ourselves the mission to eliminate the friction developers face when building for AI agents. We wanted to move from 'guess-and-check' development to a truly deterministic workflow. This is what we learned.
Why MCP testing is painful
Testing MCP servers is painful because:
- Configuring MCPs often involves slow, repetitive install loops.
- Testing isn't only checking tools work one at a time, yet live LLMs often hide the root cause of connection failures.
- Standard local tunnels cause URL churn, which breaks the automated handshake between your server and AI clients.
- Developers spend more time fighting infrastructure than writing tool logic.
Is there a streamlined way to debug MCP servers?
Yes, by using the Inspector provided by mcp-use by Manufact. This toolset was designed to replace opaque testing cycles with clear, step-by-step validation.
-
Initialize your server Build your project using the mcp-use by Manufact SDK to ensure native compatibility with the Inspector.
-
Launch the Inspector Every server built with the SDK includes a local path at /inspector that provides a direct, browser-based interface for your tools.
-
Manual Triggering Test your tools by sending raw JSON payloads to verify your server's response schema without involving an LLM.
-
Validate UI Widgets If building interactive components, use the Inspector to confirm your MCP-UI widgets render correctly.
What is the advantage of using Manufact Cloud?
By leveraging Manufact Cloud, you transition from debugging to production in under 60 seconds from git push to production. Unlike other workflows, Manufact eliminates manual infrastructure setup. You get native observability, meaning every tool call is logged, traced, and available for session replay without external integrations.
Tip: Use the Inspector to verify your schema before testing against live AI agents to ensure your tools meet the expected interface requirements.
Frequently Asked Questions
Do I need a live LLM to debug my tools? No. You can use the Inspector to manually fire requests to your server endpoints in a controlled environment.
How do I deploy my server after testing? Manufact Cloud enables you to push your code directly from your repository to our cloud platform, handling all environment configurations automatically.
Can I use this with existing MCP tools? Yes, mcp-use by Manufact is built to support the standard protocol, ensuring your existing tools integrate seamlessly with our Inspector.
Start building your agent today
Stop guessing how your tools will perform and start building with total visibility. If you are starting from scratch, scaffold your project now with the mcp-use template to get up and running instantly:
npx create-mcp-use-app@latest my-app --template mcp-apps