mcp-onesearch-api-poc

Overview

This is a proof of concept MCP server built on the onesearch-api using the naked @modelcontextprotocol/sdk for Node.js. It implements multiple search tools including simple search, 'more like this' functionality, document fetching, and various browse scenarios with specialty topics, article types, and categories. The server also supports advanced search features such as exact phrase matching and logical OR operations. It's an early-stage implementation focused on demonstrating how to MCP-enable existing search APIs.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• simple_search

  Simple search using /simple?query=

  Try:Search for information about artificial intelligenceTry:Find articles about climate change
• more_like_this

  Find similar content to a document

  Try:Find articles similar to the one I just readTry:Show me content like this document
• document_fetch

  Fetch document content with /content endpoint

  Try:Get the full content of article 12345Try:Retrieve document with ID 67890
• browse_specialty

  Browse by specialty

  Try:Browse articles in cardiology specialtyTry:Show me content in oncology specialty
• browse_topic

  Browse by topic

  Try:Browse articles about diabetes managementTry:Find content on machine learning topics
• browse_ptopic

  Browse by primary topic

  Try:Browse primary topics in medicineTry:Show me content on primary education topics
• browse_subtopic

  Browse by subtopic

  Try:Browse cardiology subtopicsTry:Find content on machine learning subtopics
• browse_article_type

  Browse by article type

  Try:Find review articlesTry:Show me research articles only
• browse_article_category

  Browse by article category

  Try:Browse articles in medical categoryTry:Show me content in technology category
• browse_article_category_subheading

  Browse by article category subheading

  Try:Browse cardiology subheading articlesTry:Find content in AI research subheading
• browse_cme

  Browse continuing medical education content

  Try:Find CME credits in cardiologyTry:Show me CME articles on pediatrics
• exact_phrase_search

  Search for exact phrase using /advanced endpoint

  Try:Search for exact phrase "machine learning"Try:Find articles containing "evidence-based medicine"

Comparable tools

Installation

{
  "mcpServers": {
    "onesearch-api": {
      "command": "node",
      "args": ["path/to/mcp-onesearch-api-poc/server.js"]
    }
  }
}

FAQ

What is onesearch-api?

onesearch-api appears to be a search API service that this MCP server is integrating with. The README doesn't provide details about the API itself, only how it's being exposed through MCP tools.

Does this server implement authentication?

Authentication is listed as a TODO item in the README. Currently, the server doesn't appear to have authentication implemented, though there are plans to add it for attribution and potential monetization.

Compare mcp-onesearch-api-poc with