MedifinderMCP Server

What is MedifinderMCP?

MedifinderMCP is a Model Context Protocol (MCP) server designed for querying a medicine inventory database. It allows AI assistants like Claude to search for medicines by name or location, check availability at healthcare facilities, get stock information, and view regional statistics. It targets users who need to manage or analyze pharmaceutical inventory data through natural language interfaces.

How to use MedifinderMCP?

Install dependencies and set up a PostgreSQL database with the schema provided in the README. Configure environment variables in a .env file, then run python main.py to start the server. Integrate with Claude Desktop by running mcp install run-mcp-server.bat -f .env or by editing Claude’s configuration file manually.

Key features of MedifinderMCP

• Search medicines by name or location
• Find locations where a medicine is available
• Get stock information for a specific medicine
• View medicine statistics by region
• Diagnose database connectivity and content
• Create database tables from the schema
• Built‑in prompt templates for medicine queries

Use cases of MedifinderMCP

• Search for a medicine by name and find which nearby facilities have it in stock.
• Check the current stock level and consumption history of a specific medicine.
• Analyze regional availability and stock status across the healthcare system.
• Troubleshoot database connections and inspect table structures via diagnostic tools.

FAQ from MedifinderMCP

What database system does MedifinderMCP require?

PostgreSQL. You must create a database named medifinderbot and configure connection details in the .env file.

How do I create the database schema?

Start the server and use the built‑in create_database_schema tool. It will create all tables defined in the models.

What tools are available for troubleshooting?

The server provides diagnose_database, troubleshoot_connection, and create_database_schema tools to check connectivity, table structure, and data presence.

How do I integrate MedifinderMCP with Claude Desktop?

You can run mcp install run-mcp-server.bat -f .env from the project directory, or manually add the server configuration to Claude Desktop’s config file.

Are there any search limits?

Yes. The MAX_SEARCH_RESULTS environment variable (default 50) limits the number of results, and the SEARCH_SIMILARITY_THRESHOLD (default 0.3) controls how similar results must be to the query.