MCP cover image
See in Github
2025-04-06

Un serveur MCP Python pour l'API de HireBase.org

1

Github Watches

1

Github Forks

3

Github Stars

HireBase MCP Server

A Model Context Protocol (MCP) server providing tools to interact with the HireBase Job API.

License: MIT

Available MCP Interactions

This server exposes the following MCP interactions:

Tools

  • search_jobs: Search for jobs using the HireBase API based on various criteria (keywords, title, location, salary, etc.).
    • Parameters: query, and_keywords, or_keywords, not_keywords, title, category, country, city, location_type, company, salary_from, salary_to, salary_currency, years_from, years_to, visa, limit.
  • get_job: Retrieve detailed information about a specific job using its HireBase ID.
    • Parameters: job_id.

Prompts

  • create_candidate_profile: Generates a structured prompt based on candidate details (name, LinkedIn, website, resume text) to help guide job searching.
    • Parameters: name, linkedin_url, personal_website, resume_text.

Client Setup (Examples: Claude Desktop, Cursor)

To use this server with an MCP client like Claude Desktop or Cursor, you need to configure the client to run the server process and optionally provide the HireBase API key.

  1. Ensure uv is installed: curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Obtain a HireBase API Key (optional): Request a key from HireBase You can set this as an environment variable (HIREBASE_API_KEY) or just leave it empty.

  3. Configure your client:

    • Using uvx:

      • Claude Desktop: Edit your claude_desktop_config.json:
        {
          "mcpServers": {
            "hirebase": {
              "command": "uvx",
              "args": [
                "hirebase-mcp" 
              ],
              "env": {
                "HIREBASE_API_KEY": "" 
              }
            }
          }
        }
        
      • Cursor: Go to Settings > MCP > Add Server:
        • Mac/Linux Command: uvx hirebase-mcp (Adjust package name if needed)
        • Windows Command: cmd
        • Windows Args: /c, uvx, hirebase-mcp (Adjust package name if needed)
        • Set the HIREBASE_API_KEY environment variable in the appropriate section.
    • Running from source via Python (Alternative):

      1. Clone the repo and note where you clone it to
      2. Claude Desktop: Edit your claude_desktop_config.json:
      {
          "mcpServers": {
              "hirebase": {
                  "command": "uv",
                  "args": [
                      "run",
                      "--with",
                      "mcp[cli]",
                      "--with",
                      "requests",
                      "mcp",
                      "run",
                      "PATH_TO_REPO/src/hirebase_mcp/server.py"
                  ]
              }
          }
      }
      

Development

This project uses:

  • uv for dependency management and virtual environments
  • ruff for linting and formatting
  • hatch as the build backend

Common Tasks

# Setup virtual env
uv venv

# Install dependencies
uv pip install -e .

# install cli tools
uv tool install ruff

# Run linting
ruff check .

# Format code
ruff format .

Environment Variables

  • HIREBASE_API_KEY (required): Your API key for accessing the HireBase API. The server needs this to make authenticated requests for job data.

Testing

This project uses pytest for testing the core tool logic. Tests mock external API calls using unittest.mock.

  1. Install test dependencies:
# Ensure you are in your activated virtual environment (.venv)
uv pip install -e '.[test]'
  1. Run tests:
# Example command
pytest

Contributing

Contributions are welcome.

License

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

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Contraband Interactive
  • Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • rustassistant.com
  • Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.

  • ShrimpingIt
  • Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX

  • modelcontextprotocol
  • Serveurs de protocole de contexte modèle

  • Mintplex-Labs
  • L'application tout-en-un desktop et Docker AI avec chiffon intégré, agents AI, constructeur d'agent sans code, compatibilité MCP, etc.

  • ravitemer
  • Un puissant plugin Neovim pour gérer les serveurs MCP (Protocole de contexte modèle)

    Reviews

    1 (1)
    Avatar
    user_T2t5qMZj
    2025-04-16

    As a loyal user of hirebase-mcp, I am thoroughly impressed by its seamless functionality and ease of use. jhgaylor has developed an exceptional tool that integrates perfectly into my workflow. The documentation is clear, and the community support is outstanding. Highly recommended for anyone needing a reliable MCP application! Check it out at the provided GitHub link.