MCP Server Integrations
Model Context Protocol (MCP) servers extend Claude Code capabilities with specialized tools and integrations.
Available MCP Servers
| Server | Purpose | Status |
|---|---|---|
| Context7 | Up-to-date library documentation | Optional |
| Sequential | Multi-step reasoning tools | Optional |
| Playwright | Browser automation (Microsoft) | Optional |
| Memory | Persistent knowledge graph | Optional |
| Filesystem | Secure file operations | Optional |
Installation
Prerequisites
- Node.js 18+
- npx available in PATH
Global Configuration
MCP servers are configured in your Claude Code settings:
Location: ~/.claude/settings.json (user) or .mcp.json (project)
Quick Setup
- Copy the configuration for your platform (see below)
- Add to your
.mcp.jsonorsettings.jsonundermcpServers - Restart Claude Code
Platform-Specific Configuration
MCP server configuration differs between platforms:
Linux / macOS
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Windows
Windows requires the cmd /c wrapper to execute npx:
{
"mcpServers": {
"context7": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@upstash/context7-mcp"]
}
}
}
Note
: The
.mcp.jsonincluded in this repository uses Windows syntax. Linux/macOS users should use the configurations in this README.
Server Configurations
Context7 (Documentation Lookup)
Provides up-to-date documentation for libraries and frameworks.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
Usage: Ask about any library and get current documentation.
Tools:
resolve-library-id- Find library IDs for documentation lookupget-library-docs- Fetch documentation for a specific library
Sequential Thinking
Provides structured reasoning tools for complex problem-solving.
{
"mcpServers": {
"sequential": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
Usage: Complex analysis with step-by-step reasoning.
Tools:
sequentialthinking- Dynamic problem-solving through thought sequences
Playwright (Browser Automation)
Microsoft's browser automation using accessibility tree for fast, LLM-friendly interaction.
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
}
}
}
Usage: Web testing, screenshots, form automation.
Key Features:
- Fast and lightweight - uses accessibility tree, not pixels
- LLM-friendly - no vision models needed
- Supports Chrome, Firefox, WebKit, Edge
- Device emulation and profile management
Command-Line Options:
--browser <browser>- Browser to use (chrome, firefox, webkit, msedge)--headless- Run browser in headless mode--viewport-size <size>- Viewport size (e.g., "1280x720")--device <device>- Device to emulate (e.g., "iPhone 15")
Memory (Persistent Knowledge Graph)
Maintains persistent memory across sessions using a local knowledge graph.
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
Usage: Remember information across conversations and sessions.
Tools:
create_entities- Create new entities in the knowledge graphcreate_relations- Create relationships between entitiesadd_observations- Add observations to entitiesdelete_entities- Remove entities from the graphdelete_observations- Remove observationsdelete_relations- Remove relationshipsread_graph- Read the entire knowledge graphsearch_nodes- Search for entitiesopen_nodes- Open specific entities by name
Filesystem (Secure File Operations)
Enables secure file operations with configurable access controls.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
Usage: Read, write, and manage files with access controls.
Tools:
read_file- Read file contentsread_multiple_files- Read multiple files at oncewrite_file- Write content to a fileedit_file- Make edits to a filecreate_directory- Create a new directorylist_directory- List directory contentsdirectory_tree- Get directory tree structuremove_file- Move or rename filessearch_files- Search for files by patternget_file_info- Get file metadata
Note: The last argument specifies the allowed directory (. for current directory).
Full Configuration Example
Linux / macOS
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"sequential": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
Windows
{
"mcpServers": {
"context7": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@upstash/context7-mcp"]
},
"sequential": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"playwright": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@playwright/mcp"]
},
"memory": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-memory"]
},
"filesystem": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}
Optional Additional Servers
These servers can be added for extended functionality:
| Server | Package | Purpose |
|---|---|---|
| Fetch | mcp-server-fetch (uvx) |
Web content fetching |
| Brave Search | @modelcontextprotocol/server-brave-search |
Web search (requires API key) |
| PostgreSQL | @modelcontextprotocol/server-postgres |
Database access |
| Sentry | @sentry/mcp-server |
Error tracking |
| GitHub | @github/mcp-server |
GitHub API operations |
Verification
After configuration, verify servers are loaded:
- Start a new Claude Code session
- Check for MCP tools in available capabilities
- Test with a simple request
Troubleshooting
Server Not Loading
- Check Node.js version (18+ required)
- Verify npx is in PATH
- Check for typos in configuration
- Review Claude Code logs
Permission Errors
- Ensure network access for package installation
- Check firewall settings
- Verify npm registry access
Slow Startup
- First run downloads packages (one-time)
- Subsequent starts should be faster
- Consider pre-installing packages globally
Security Notes
- MCP servers run with your user permissions
- Review server source before installing
- Playwright has browser access - use carefully
- Context7 makes network requests to documentation sources
- Filesystem server restricts access to specified directories