open-index/open-npm huggingface dataset:
npm package: @mcpindex/server
Description: MCPIndex Server
Latest version: 0.1.1

# MCPIndex

<p align="left">
  <a href="https://www.npmjs.com/package/@mcpindex/server"><img alt="npm (scoped)" src="https://img.shields.io/npm/v/%40mcpindex%2Fserver?label=npm&logo=npm"></a>
  <a href="https://www.npmjs.com/package/@mcpindex/server"><img alt="npm downloads" src="https://img.shields.io/npm/dm/%40mcpindex%2Fserver.svg?logo=npm"></a>
  <img alt="Node version" src="https://img.shields.io/badge/Node-20%2B-339933?logo=node.js&logoColor=white">
</p>

**Let your LLM find the right tool automatically – no manual setup for each tool!**

MCPIndex is a Model Context Protocol (MCP) server that enables LLMs to automatically discover and invoke suitable MCP tools, eliminating the need to manually find and configure suitable MCP tools for every task.

<p align="center">
  <br>
  <img src="https://mcpindex.io/resources/example.png" alt="Use Case Example" width="500" />
</p>

## ✨ Features
- **Massive tool index**: Thousands of MCP tools indexed
- **Quality-aware selection**: Real usage review statistics to help LLMs pick the best tool
- **Seamless auth**: Auto prompt when a tool needs to connect to your account
- **Local secret storage**: All auth information is processed locally and stored in your machine's key store

## 🧰 Prerequisites 
Node.js 20+ and `npx` available.

## 🚀 Usage
- Add the following to your LLM app (e.g. Cursor, Claude, Vscode, Windsurf, etc.)'s MCP config:

```json
{
  "MCPIndex": {
    "command": "npx",
    "args": ["-y", "@mcpindex/server"]
  }
}
```

- Add the following to your LLM app’s rules/system prompt or simply append it to your prompt so the LLM uses MCPIndex effectively:

> You can optionally search for tools using MCPIndex (3 searches maximum for one task) and invoke suitable tools if any. Prompt the user to authorize if required and not already done.

## 🛠️ Troubleshooting

- **Command not found**: Ensure Node.js 20+ is installed and `npx` is available in your PATH.
- **No tools visible in client**: Confirm your LLM app points to `npx -y @mcpindex/server` and restart the app after changing config.