CostPlusDrugs.com

Model Context Protocol(MCP)サーバーであり、AIエージェントにCost Plus Drugs薬局サービスの手頃なアクセスを提供し、透明な医薬品価格と包括的な薬剤情報を提供します。

ドキュメント

Cost Plus Drugs MCP Server

A Model Context Protocol (MCP) server that provides AI agents with affordable access to Cost Plus Drugs pharmacy services, offering transparent medication pricing and comprehensive drug information.

🌟 Features

The Cost Plus Drugs MCP server empowers AI agents with:

  • 🔍 Smart Medication Search: Find medications by name, active ingredient, or related terms
  • 📂 Category Navigation: Browse 95+ medication categories including specialized health areas
  • 💊 Comprehensive Drug Database: Access detailed medication information with transparent pricing
  • 📄 Advanced Pagination: Navigate through large result sets efficiently with smart filtering
  • 🏥 Healthcare Integration: Support for women's health, chronic conditions, and specialized treatments

🚀 Quick Start

For AI Agents & Developers:

  1. Install & Setup:

    git clone https://github.com/your-username/cost-plus-drugs-mcp-server.git
    cd cost-plus-drugs-mcp-server
    npm install && npm run build
    
  2. Start the Server:

    # Stdio mode (recommended for AI agents)
    npm start
    
    # HTTP mode (port 3000)
    npm run start:http
    

🛠️ Available Tools

search_medicines

Find medications by exact name (generic or brand)

{
  "tool": "search_medicines",
  "arguments": {
    "query": "metformin"
  }
}

get_collections

Browse all medication categories or search for specific ones

{
  "tool": "get_collections",
  "arguments": {}
}

get_all_products

Retrieve medications with filtering by category and pagination (always sorted alphabetically by name)

{
  "tool": "get_all_products",
  "arguments": {
    "first": 10,
    "collection": 31
  }
}

📚 Available Resources

cost_plus_drugs_collections

Complete medication category database

  • URI: cost-plus-drugs://collections
  • Categories: 95 specialized health categories
  • Filtering: Search by name or slug with ?query=diabetes

⚙️ Configuration

Customize with environment variables:

  • API_BASE_URL: GraphQL API endpoint (default: https://www.costplusdrugs.com)
  • API_TIMEOUT_MS: Request timeout in milliseconds (default: 30000)
  • API_RETRY_ATTEMPTS: Retry attempts for failed requests (default: 3)
  • MCP_SERVER_NAME: Server identifier (default: cost-plus-drugs-mcp-server)

💡 Sample Use Cases

Healthcare AI Assistant:

  • Compare medication prices across categories
  • Find affordable alternatives for expensive treatments
  • Provide transparent pricing information to patients
  • Navigate complex medication categories efficiently

Research Applications:

  • Analyze medication pricing trends
  • Study category-specific treatment options
  • Generate comprehensive drug information reports

📖 Development Guidelines

For comprehensive development instructions and AI agent integration guidelines, see AGENTS.md.

📋 API Response Format

All tools return structured responses with:

  • Complete medication data (pricing, forms, availability)
  • Clinical context and safety information
  • Pagination support for large datasets
  • Error handling with recovery suggestions

🔒 License

Licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

For commercial licensing inquiries, please contact the author.


Medical Disclaimer: This software provides informational purposes only and is not intended for medical diagnosis or treatment decisions. Always consult qualified healthcare professionals for medical advice and verify information with official sources.