@cdhdd/mcp-tools - MCP Servers for Developer Workflows

MCP (Model Context Protocol) servers that give AI coding assistants (Claude Code, Cursor, Windsurf, etc.) direct access to your filesystem, GitHub, and npm registry.

🚀 Quick Start

# Install all tools globally
npm install -g @cdhdd/mcp-tools

# Or use directly with npx
npx @cdhdd/mcp-tools filesystem
npx @cdhdd/mcp-tools github
npx @cdhdd/mcp-tools search

📦 Included Servers

1. Filesystem Server (mcp-filesystem)

Let AI assistants read, write, and search files on your local machine.

# Run with current directory access
mcp-filesystem

# Restrict to specific directories
mcp-filesystem /path/to/project /path/to/docs

Tools:

• read_file - Read file contents
• write_file - Create or overwrite files
• list_directory - Browse directories
• search_files - Search for files by pattern
• get_file_info - Get file metadata

2. GitHub Server (mcp-github)

Let AI assistants interact with GitHub repositories, issues, and code.

# Set your GitHub token for authenticated access
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

# Start the server
mcp-github

Tools:

• get_repo - Repository info and stats
• search_repos - Search GitHub repositories
• list_files - Browse repository files
• read_file_from_github - Read files from GitHub
• get_readme - Get README content
• list_issues - List repository issues
• search_code - Search code across GitHub

3. Search Server (mcp-search)

Let AI assistants search npm registry for packages and documentation.

mcp-search

Tools:

• search_npm - Search npm packages
• npm_package_info - Package details
• npm_downloads - Download statistics
• search_npm_dependencies - Find dependencies

🔧 Configuration with AI IDEs

Claude Code

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": ["@cdhdd/mcp-tools", "filesystem", "/path/to/project"]
    },
    "mcp-github": {
      "command": "npx",
      "args": ["@cdhdd/mcp-tools", "github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Settings → Features → MCP Servers → Add new:

Name: Filesystem
Type: command
Command: npx @cdhdd/mcp-tools filesystem /path/to/workspace

Windsurf

Add to .windsurf/config.json:

{
  "mcpServers": {
    "mcp-search": {
      "command": "npx",
      "args": ["@cdhdd/mcp-tools", "search"]
    }
  }
}

🛡️ Security

• Filesystem server only allows access to explicitly permitted directories
• GitHub server uses token-based authentication (read-only by default)
• Search server only makes outbound HTTP requests (no local access)

📝 License

MIT © XiaoJia AI Tools