Skip to main content
Glama

fastroute

Local MCP plugin: when an agent receives a new task, retrieve Top-N recommendations from all locally installed skills (user-level/plugin-level/project-level). It only recommends, never executes.

The indexing method comes from SkillRouter (arXiv 2603.22455): all-field segmented multi-vector (one vector for name+description + one vector for each ~800-character chunk of body text); for a query, cosine similarity is computed against each chunk, and skill scores are max-pooled.

Tools

Tool

Purpose

recommend_skills

Retrieves the most relevant skill before a task starts; returns score, tier (auto/prompt/skip, reference values), invocation name and path

reindex_skills

Incrementally rebuilds the index after installing/removing skills (mtime diff); no session restart needed

Related MCP server: skills-mcp-server

Installation (Claude Code)

claude mcp add fastroute -- node /absolute/path/to/fastroute/dist/index.js

Data and Models

  • Data directory ~/.fastroute (overridden by FASTROUTE_DATA_DIR): fastroute.db, config.json, models/

  • Embedding model: Xenova/paraphrase-multilingual-MiniLM-L12-v2 (q8, ~135 MB), downloaded online when the tool is first invoked; defaults to the ModelScope mirror (FASTROUTE_EMBEDDING_HOST can point back to https://huggingface.co); if a ~/.knowyoubetter/models cache already exists, it is reused directly

  • The model is a hard dependency: when offline and no cache is available, the tool returns an error and download instructions; there is no lexical fallback

  • config.json can override: chunkSize(800), autoThreshold(0.9), promptThreshold(0.6), topK(5), userSkillsDir, pluginCacheDir, projectSkillsEnabled

  • After changing chunkSize, existing indexes are not automatically re-chunked: delete ~/.fastroute/fastroute.db and then call reindex_skills

Development

npm install
npm test            # 单测 + 集成(fake embedder,不联网)
npm run test:real   # 真实 embedding 冒烟(首次下载模型)
npm run eval        # distractor 评测:Hit@1/Hit@5/MRR
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    FastMCP is a comprehensive MCP server allowing secure and standardized data and functionality exposure to LLM applications, offering resources, tools, and prompt management for efficient LLM interactions.
    3
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A high-performance MCP server that provides BM25-ranked search and structured access to over 1,300 AI skills, enabling context-efficient discovery and usage of AI capabilities while minimizing token consumption.
    13 npm
    ISC
  • F
    license
    Not graded
    quality
    B
    maintenance
    A hierarchical MCP server for managing skill definitions with a browsable tree structure and full-text search. It allows AI agents to efficiently discover and use skills without consuming context tokens.
    -