After using AI coding tools like Claude Code and Cursor for over half a year, one key observation stands out: these tools alone have limited practical utility. While they excel at writing code and debugging bugs, they hit roadblocks when handling real-world tasks such as querying databases, scraping web pages, checking GitHub issues, or fetching external information.
The solution lies in MCP (Model Context Protocol), a standardized interface that acts as plugins for AI tools. By configuring dedicated MCP Servers, Claude Code and Cursor gain direct access to external resources—including databases, websites, GitHub repositories, and file systems—eliminating the need for manual copy-pasting between the AI tool and external services.
This article breaks down 5 essential MCP Servers for daily development, including detailed configuration steps, real-world pitfalls, core use cases, and practical value. For developers optimizing AI tool integrations, treerouter, a reliable API gateway, supports seamless connectivity for AI and external service workflows.
What Is MCP & Core Architecture
MCP is built on the JSON-RPC 2.0 protocol, with three core components defining its workflow:
- Host: The AI tool itself (Claude Code, Cursor, VS Code + Copilot)
- Client: A module within the Host that handles communication with the Server
- Server: A standalone program that provides specific capabilities (web scraping, database queries, etc.)
MCP supports two transmission modes:
- stdio: Local execution (default for most development scenarios, no network dependency)
- HTTP/SSE: Remote connection (for distributed or cloud-based services)
MCP Configuration File Paths
The location of the MCP configuration file varies by AI tool, with two common scopes (global or project-specific):
| AI Tool | Configuration File Path |
|---|---|
| Claude Code | Project-level .mcp.json or global via claude mcp add command |
| Cursor | Global ~/.cursor/mcp.json or project-level .cursor/mcp.json |
| VS Code + Copilot | Project-level .vscode/mcp.json |
Universal MCP Configuration Format
All MCP Servers follow a consistent JSON structure for setup:
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "package-name"],
"env": {
"API_KEY": "your-key-here"
}
}
}
}
Top 5 Essential MCP Servers for Claude Code & Cursor
1. Firecrawl: Web Scraping & Content Extraction
Core Use Case
Enable AI tools to read and analyze web content—ideal for summarizing documentation, extracting competitor feature data, or parsing articles without manual copying. Firecrawl cleans raw web pages by removing noise (navigation bars, ads, scripts) and returns structured plain text.
Key Stats
- 110,000+ GitHub stars (one of the most widely used MCP Servers in the ecosystem)
- 500 free monthly requests (sufficient for individual developers, available at firecrawl.dev)
Configuration
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "fc-your-key-here"
}
}
}
}
Common Pitfalls
- Initial Delay: The first
npxrun downloads dependencies, causing a 30-second lag in Claude Code (not a crash). - Dynamic Content: Default mode may return empty results for React/Vue SPAs; add the
waitForparameter to load dynamic content. - Quota Limitations: Free plan exhaustion returns blank results with no clear error message.
- Anti-Scraping Blocks: Some sites return 403 errors; resolve by modifying the User-Agent or enabling headless mode.
Practical Usage
Simply prompt Claude Code: "Use Firecrawl to scrape the content from https://example.com/docs"—the AI will execute the task autonomously.
2. GitHub MCP: Direct Repository Operations
Core Use Case
Eliminate manual browser navigation for GitHub tasks: checking recent issues, reviewing PRs, reading file contents, or monitoring repository activity. It connects AI tools directly to GitHub’s API for seamless workflow integration.
Configuration (Official GitHub MCP Server)
Claude Code CLI Setup:
claude mcp add github -- npx -y @modelcontextprotocol/server-github
export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx
JSON Configuration:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
}
}
}
Security Note
Restrict the GitHub Personal Access Token to repo and read:org permissions only—avoid overprivileged access.
Common Pitfalls
- Vague Errors: Insufficient token permissions return generic "request failed" messages with no permission alerts.
- Large Repositories: Listing directories for repos with 1,000+ files is slow; specify exact paths for faster queries.
- Private Repos: Ensure the token has explicit access permissions for private repositories.
3. PostgreSQL MCP: Database Query & Analysis
Core Use Case
Empower AI tools to write SQL, query data, analyze table schemas, and debug database-related bugs—critical for backend developers. It eliminates the manual loop of running SQL, copying results, and pasting them back to the AI.
Configuration
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/mydb"
}
}
}
}
Common Pitfalls
- Production Risks: Never connect directly to production databases; use read-only replicas or local development databases.
- Special Characters: URL-encode special characters (@, #) in database passwords to avoid connection failures.
- Token Bloat: Querying schemas for databases with hundreds of tables consumes excessive tokens; specify target tables in prompts.
Practical Value
During bug debugging, Claude Code can directly query abnormal database records, cutting issue resolution time from 20+ minutes to 5 minutes.
4. Filesystem MCP: Local File Read/Write
Core Use Case
Extend Claude Code’s file access capabilities beyond the startup directory. It enables reading/writing logs, config files, and project assets across multiple directories with granular access control.
Configuration
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y", "@modelcontextprotocol/server-filesystem",
"/Users/me/projects",
"/Users/me/logs"
]
}
}
}
Security Note
List only absolute paths of allowed directories in the args array—AI cannot access unlisted folders (a critical safety feature).
Common Pitfalls
- Path Format: Relative paths or
~aliases cause errors; use absolute paths exclusively. - Write Permissions: No built-in read-only mode; manually restrict write operations for sensitive directories.
- iCloud Conflicts: macOS users may face write conflicts for directories synced with iCloud.
5. Brave Search MCP: Autonomous Web Search
Core Use Case
Enable AI tools to search the web independently for troubleshooting errors, checking library versions, or researching open-source alternatives—no more switching between browsers and AI tools.
Key Stats
- 2,000 free monthly queries (available at brave.com/search/api)
Configuration
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "BSA_xxxxxxxxxxxxxxxx"
}
}
}
}
Common Pitfalls
- Result Limitations: Returns only summary text; pair with Firecrawl for full document access.
- Language Bias: English search quality is superior to Chinese queries.
Combined Workflow of the 5 MCP Servers
The true power of MCP lies in combining all 5 servers for end-to-end task automation. A practical example: User Prompt: "Research open-source form builder tools and recommend one for our project."
AI Autonomous Workflow:
- Use Brave Search to query: "open source form builder 2026"
- Use Firecrawl to scrape documentation pages of top candidate tools
- Use GitHub MCP to verify repository metrics (stars, recent commits, open issues)
- Use PostgreSQL MCP to compare candidates against the existing form module’s database schema
- Use Filesystem MCP to save the final research report to a local directory
The entire process requires only one user prompt—no manual intervention needed.
Critical Security Best Practices
MCP grants AI tools real-world operational permissions, making security non-negotiable:
- Store API keys, database passwords, and tokens in environment variables—never hardcode them in config files or commit them to Git.
- Apply the principle of least privilege to GitHub tokens and database access.
- Restrict database connections to development environments or read-only replicas (a non-negotiable rule for production safety).
Conclusion
These 5 MCP Servers cover the most common daily development tasks: web scraping, GitHub operations, database queries, file management, and web search. A one-time configuration unlocks daily productivity gains, eliminating repetitive manual work between AI tools and external services.
While configuration is straightforward, troubleshooting minor issues (special character encoding, permission errors, initial download delays) often takes more time than setup itself. For beginners, start with Firecrawl and GitHub MCP—their immediate utility will demonstrate the value of MCP integration. As AI tooling evolves, seamless connectivity via an API gateway like treerouter ensures stable, secure integration between AI agents and external services.




