What is Mcp Tools Guide

mcp-tools-guide is a comprehensive guide designed to assist users in setting up and configuring tools related to the Model Context Protocol (MCP).

Use cases

Use cases include file management in applications, database operations for data storage, web searches for information retrieval, and managing GitHub repositories for version control.

How to use

To use mcp-tools-guide, follow the configuration instructions provided for each tool, ensuring that you update the correct configuration files based on your client application.

Key features

Key features include support for various tools such as Filesystem for file operations, SQLite for database management, Brave Search for search capabilities, and GitHub for repository management.

Where to use

mcp-tools-guide can be used in software development environments, particularly where Model Context Protocol tools are integrated for improved data handling and management.

MCP Tools Guide

Configuration Locations

Before setting up any tools, ensure you’re updating the correct configuration file based on your client:

Claude Desktop App:

~/Library/Application Support/Claude/claude_desktop_config.json

Cline (VS Code Extension):

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Available Tools

1. Filesystem (@modelcontextprotocol/server-filesystem)

   • File operations (read, write, list, search)
   • Directory management
   • Configuration template:

2. SQLite (mcp-server-sqlite)

   • Database operations
   • Query execution
   • Configuration template:

3. Brave Search (@modelcontextprotocol/server-brave-search)

   • Web and local search capabilities
   • Configuration template:

4. GitHub (@modelcontextprotocol/server-github)

   • Repository management
   • Code access and search
   • Issue tracking
   • Important Notes:
     • For pushing multiple files, use push_files instead of create_or_update_file
     • Repository must exist before pushing files
     • Token needs appropriate permissions (Contents: Read & write)
   • Configuration template:

5. Puppeteer (@modelcontextprotocol/server-puppeteer)

   • Browser automation
   • Web scraping
   • Configuration template:

6. YouTube Server (@chrishayuk/mcp-youtube-server)

   • Video transcript fetching
   • Configuration template:

7. Home Assistant (@modelcontextprotocol/server-homeassistant)

   • Home automation control and monitoring
   • Device state management
   • Service calls and automation
   • Configuration template:

Working Tools (as of January 2025)

Confirmed Working

1. Brave Search (Web & Local Search)
2. Filesystem (File Operations)
3. SQLite (Database)
4. GitHub (Full functionality)
5. Puppeteer (Browser Automation)
6. YouTube Server (Transcripts)
7. Home Assistant (Device control)

GitHub Tool Notes

• Successfully creates private repositories
• Handles multiple file pushes
• Requires appropriate token permissions:
  • Actions (Read & write)
  • Administration (Read & write)
  • Contents (Read & write)
  • Metadata (Read-only)
  • Pull requests (Read & write)
  • Workflows (Read & write)

Home Assistant Tool Notes

• Successfully connects to local or remote Home Assistant instances
• Supports all Home Assistant service calls
• Requires:
  • Valid Home Assistant URL
  • Long-Lived Access Token with appropriate permissions
  • Network access to Home Assistant instance

Installation and Configuration

1. Install the desired server package:

   npm install @modelcontextprotocol/server-name
   

2. Add the configuration to your client’s config file (see Configuration Locations above)

3. Restart your client (Claude Desktop or Cline)

4. Test the functionality with a simple command

Common Issues

1. Command not found

   • Try switching between npx and uvx
   • Verify package installation
   • Check command spelling

2. Connection errors

   • Verify environment variables
   • Check network connectivity
   • Ensure service/API is accessible

Last updated: January 17, 2025