Skip to content
Back to search

mcpadvisor

MCP Advisor & Installation - Use the right MCP server for your needs

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/istarwyh/mcpadvisor with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/istarwyh/mcpadvisor'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/istarwyh--mcpadvisor/badge.svg)](/listings/istarwyh--mcpadvisor)

HTML

<a href="/listings/istarwyh--mcpadvisor"><img src="/api/listings/istarwyh--mcpadvisor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installation

The fastest way is to integrate MCP Advisor through MCP configuration:

{
  "mcpServers": {
    "mcpadvisor": {
      "command": "npx",
      "args": ["-y", "@xiaohui-wang/mcpadvisor"]
    }
  }
}

Add this configuration to your AI assistant's MCP settings file:

- MacOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%AppData%\Claude\claude_desktop_config.json`

Installing via Smithery

To install Advisor for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@istarwyh/mcpadvisor):

npx -y @smithery/cli install @istarwyh/mcpadvisor --client claude

For more installation methods and detailed configuration, see the [Quick Start Guide](docs/GETTING_STARTED.md).

Optional: Local Meilisearch (improves recommendations)

To boost recommendation quality, you can run a local Meilisearch instance:

pnpm meilisearch:start

This starts Meilisearch at http://localhost:7700, bootstraps the `mcp_servers` index from local data, and persists environment variables to `~/.meilisearch/env`. Load them in your current shell with:

source ~/.meilisearch/env

Or enable it automatically with a single flag when launching MCPAdvisor (no manual env needed):

{
  "mcpServers": {
    "mcpadvisor": {
      "command": "npx",
      "args": ["-y", "@xiaohui-wang/mcpadvisor", "--local-meilisearch"]
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MCP Advisor
  2. [English](README.md) | [简体中文](README_zh.md)
  3. MCP Advisor helps an MCP client discover servers for a task and obtain installation
  4. guidance. It aggregates search providers and returns recommendations; it does
  5. **not** install a server, edit your client configuration, or verify a recommended
  6. server's safety for you.
  7. ## Start here
  8. 1. **Use the current source:** follow the [Quick Start](docs/GETTING_STARTED.md)
  9. for MCP 2026-07-28 clients, stdio, or HTTP.
  10. 2. **Need an older client?** The published npm version `1.0.5` is a separate
  11. legacy release. Do not apply the current source's transport configuration to it.
  12. 3. **Develop or diagnose:** read [Contributing](CONTRIBUTING.md),
  13. [Architecture](docs/ARCHITECTURE.md), and [Technical Reference](docs/TECHNICAL_REFERENCE.md).
  14. For current protocol failures, start with the [migration guide](docs/MCP_2026_MIGRATION.md).
  15. ### Award and project background
  16. MCP Advisor is developed by the `mcpadvisor` team, which won second prize at the
  17. inaugural OceanBase AI Hackathon in 2025 (首届 OceanBase AI 黑客松大赛).
  18. The [organizer's May 19 event report](https://www.modb.pro/db/1924452526657646592)
  19. names the team and describes its MCP search and recommendation project; the event
  20. concluded in Guangzhou on May 17, 2025.
  21. The [author's OceanBase community post](https://ask.oceanbase.com/t/topic/35625183)
  22. connects that project to this repository. This is historical recognition, not a
  23. benchmark or endorsement of every current feature.
  24. ## What is available?
  25. | Capability | Current-source status |
  26. | --- | --- |
  27. | `recommend-mcp-servers` | Task-based recommendations with optional keywords/capabilities |
  28. | `install-mcp-server` | Installation guidance/configuration text only; no automatic installation |
  29. | Meilisearch, Compass, GetMCP | Constructed by the CLI; external availability/configuration still matters |
  30. | Offline provider | Enabled by SearchService by default; embeddings can require a model download |
  31. | Nacos discovery | Opt-in; CLI requires address, username **and** password |
  32. | Cline Marketplace | Implemented, opt-in via `CLINE_MARKETPLACE_ENABLED=true` |
  33. | FlashRank reranking | Implemented, default off; separately started Python service and model |
  34. | Search-quality evaluation | Evaluation tooling and illustrative fixtures; not proof of production quality |
  35. | Automatic installation / quality guarantees | Not implemented / not established |
  36. The active Meilisearch provider uses text search. Offline retrieval combines text
  37. and vectors; this is not universal vector search, adaptive query weighting, or a
  38. guarantee of five results. Online providers still run alongside offline data.
  39. ## Choose a runtime
  40. ### Current source (modern protocol)
  41. Use Node.js 20+ for the application; Inspector 2.10.1 additionally requires Node.js
  42. 22.19+. Use the pinned pnpm 8.15.9 from `package.json`.
  43. ```sh
  44. git clone https://github.com/istarwyh/mcpadvisor.git
  45. cd mcpadvisor
  46. corepack enable
  47. pnpm install --frozen-lockfile
  48. pnpm run build
  49. node build/index.js
  50. ```
  51. The default is stdio. Diagnostics must not go to stdout. For local HTTP:
  52. ```sh
  53. TRANSPORT_TYPE=http SERVER_HOST=127.0.0.1 SERVER_PORT=3000 node build/index.js
  54. ```
  55. Connect a compatible MCP 2026-07-28 client to `http://127.0.0.1:3000/mcp`.
  56. See the [official SDK client example](docs/MCP_2026_MIGRATION.md#connect-with-the-official-sdk).
  57. HTTP is stateless, with a fresh protocol server per request; provider caches can
  58. remain process-scoped. Old SSE/REST modes are rejected and old HTTP paths return
  59. 410. Modern POST responses may still use SSE encoding. There is no built-in
  60. authentication or cross-origin browser CORS: keep loopback binding unless you
  61. provide an independently secured gateway. Hosting acceptance is not implied.
  62. ### Published npm 1.0.5 (legacy)
  63. ```sh
  64. npx -y @xiaohui-wang/mcpadvisor@1.0.5
  65. ```
  66. This selects the older published artifact, not the source above. Check its own
  67. client compatibility and configuration. A source checkout still declaring version
  68. 1.0.5 does not mean those source changes have been published to npm.
  69. ### Third-party installers
  70. Marketplace/Smithery listings and their installers are independently maintained.
  71. Check the selected artifact/version, permissions, and transport before running
  72. them. This guide does not certify that they deliver the current modern source.
  73. ## Configure and extend
  74. The CLI does not read `SEARCH_PROVIDER`, `SEARCH_LIMIT`, or
  75. `SEARCH_MIN_SIMILARITY`. Provider injection and `SearchOptions` belong to the
  76. programmatic SearchService API, not invented environment flags.
  77. Do not import SearchService from the npm root: the package entry is a CLI with
  78. startup side effects. See the [source-checkout API examples](docs/TECHNICAL_REFERENCE.md).
  79. | Topic | Guide |
  80. | --- | --- |
  81. | CLI, HTTP, Nacos credentials and programmatic options | [Quick Start](docs/GETTING_STARTED.md) |
  82. | Local Meilisearch lifecycle | [Local Meilisearch](docs/MEILISEARCH_LOCAL.md) |
  83. | Text-search behavior | [Full-text search](docs/full-text-search.md) |
  84. | Optional Cline source | [Cline Marketplace](docs/cline-marketplace.md) |
  85. | Optional local model service, failure fallback and privacy | [FlashRank](docs/professional-reranking.md) |
  86. | Judgments, metrics and illustrative-data limits | [Search-quality evaluation](docs/search-quality-evaluation.md) |
  87. | Inspector prerequisites and focused browser checks | [Inspector UI testing](docs/inspector-ui-testing.md) |
  88. | Modern protocol and rollback boundaries | [MCP migration](docs/MCP_2026_MIGRATION.md) |
  89. | Older operational diagnostics | [Troubleshooting](docs/TROUBLESHOOTING.md) |
  90. Troubleshooting's hosting-related revision is tracked separately in PR #40; use
  91. the migration guide for current transport behavior. No unmerged hosting
  92. configuration is part of these instructions.
  93. ## Validate a change
  94. ```sh
  95. pnpm run check
  96. pnpm test
  97. pnpm run build
  98. pnpm run test:protocol
  99. ```
  100. These cover lint/format, Vitest, production compilation, and focused offline
  101. protocol/startup checks respectively. They do not prove live provider availability
  102. or ranking quality. The aggregate Playwright suite is `pnpm run test:e2e`
  103. (`scripts/e2e/e2e.run.sh`); it needs its documented browser/service prerequisites.
  104. A selected Inspector spec is not the aggregate suite. See
  105. [Contributing](CONTRIBUTING.md) and [Inspector UI testing](docs/inspector-ui-testing.md).
  106. ## Project direction and documentation
  107. [Roadmap](docs/ROADMAP.md) preserves historical plans, not current delivery dates.
  108. Cline and FlashRank are implemented optional features, not open implementation
  109. TODOs. New provider integrations, quality claims, and deployment work need their
  110. own scope and evidence.
  111. The [documentation review record](docs/DOCUMENTATION_REVIEW.md) identifies the
  112. source baseline, verification boundaries, and language-mirror policy.
  113. Contributions are welcome through an issue and a focused, tested pull request.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.