DevFinder MCP

A Model Context Protocol (MCP) server for finding and analyzing GitHub developers based on location, technology stack, and various criteria.

🚀 Features

• Developer Search: Find GitHub users by programming language, location, followers, and repository count
• User Analysis: Get detailed information about specific GitHub users
• Tech Stack Analysis: Analyze a developer's technology stack from their repositories
• Location-based Search: Find developers in specific geographic locations
• Rate Limit Monitoring: Built-in GitHub API rate limit tracking

📦 Installation

npm install -g devfinder-mcp

🔧 Configuration

Environment Variables

Set up your GitHub token for higher API limits:

export GITHUB_TOKEN=your_github_personal_access_token

Claude Desktop Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "devfinder": {
      "command": "npx",
      "args": ["devfinder-mcp"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Development Setup

{
  "mcpServers": {
    "devfinder-dev": {
      "command": "node",
      "args": ["index.js"],
      "cwd": "/path/to/devfinder-mcp",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

🛠️ Tools

search_users

NEW! Unified search for GitHub users with optional location and technology filters, plus sorting capabilities.

Parameters:

• location (optional): Location to search for (e.g., 'San Francisco', 'Berlin', 'Tokyo')
• technology (optional): Technology/programming language (e.g., 'javascript', 'python', 'go')
• sort (optional): Sort by 'followers' (popularity), 'repositories', or 'joined' (default: best match)
• order (optional): Sort order 'asc' or 'desc' (default: 'desc')
• minRepos (optional): Minimum number of repositories
• minFollowers (optional): Minimum number of followers
• perPage (optional): Results per page (1-100, default: 30)
• page (optional): Page number (default: 1)

search_users_by_location

Search GitHub users by location.

Parameters:

• location (required): Location to search for
• perPage (optional): Results per page (default: 30)
• page (optional): Page number (default: 1)

search_users_by_technology

Search GitHub users by technology/language.

Parameters:

• technology (required): Programming language (e.g., 'javascript', 'python')
• location (optional): Optional location filter
• minRepos (optional): Minimum repositories (default: 0)
• perPage (optional): Results per page (default: 30)
• page (optional): Page number (default: 1)

get-github-user-details

Get detailed information about a specific GitHub user.

Parameters:

• username (required): GitHub username

analyze-user-tech-stack

Analyze a GitHub user's technology stack from their repositories.

Parameters:

• username (required): GitHub username
• preferredTechnologies (optional): Array of technologies to highlight in analysis

find-developers-by-location

Find developers in a specific location with optional filters.

Parameters:

• location (required): Location to search
• technology (optional): Programming language filter
• minFollowers (optional): Minimum followers (default: 10)
• limit (optional): Maximum results (1-100, default: 20)

🚀 Quick Start

1. Find JavaScript developers in San Francisco (sorted by popularity):

   Use the search_users tool with:
   - technology: "javascript"
   - location: "San Francisco"  
   - sort: "followers"

2. Find developers by location only:

   Use search_users with location: "Berlin"

3. Find Python developers worldwide (most repositories first):

   Use search_users with:
   - technology: "python"
   - sort: "repositories"

4. Get detailed info about a user:

   Use get-github-user-details with username: "octocat"

🔒 API Limits

• Without GitHub token: 60 requests per hour
• With GitHub token: 5,000 requests per hour

The server automatically tracks rate limits and includes remaining requests in responses.

🏗️ Development

Prerequisites

• Node.js 18+
• npm

Setup

git clone https://github.com/agentic-ph/devfinder-mcp.git
cd devfinder-mcp
npm install

Running

node index.js

Code Style

# Format code
npm run format

# Check formatting
npm run format:check

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.

👨‍💻 Author

John Dave Decano - [email protected]

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🔗 Links

• Repository: https://github.com/agentic-ph/devfinder-mcp
• Issues: GitHub Issues
• Model Context Protocol: https://modelcontextprotocol.io/