mcpField
O
oss-search

oss-search

Local
github.comSearch0Updated 1w ago
RepositoryVisit website

About oss-search

oss-search is an MCP server and matching CLI for local and federated open-source code search and repository discovery. It provides seven MCP tools, with optional remote backends enabled using `--live`.

Key features

  1. 01Local open-source code search
  2. 02Federated code search
  3. 03Repository discovery
  4. 04Seven MCP tools over stdio
  5. 05Matching command-line interface
  6. 06Cached Rust binary distribution

Use cases

  1. 01Find code in open-source projects
  2. 02Discover relevant repositories
  3. 03Search remote sources with `--live`
  4. 04Use search through MCP or CLI

MCP support

It exposes seven code-search and repository-discovery tools to MCP clients over stdio. The CLI provides the same functionality.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "sblattj-oss-search": {
      "command": "npx",
      "args": [
        "-y",
        "oss-search"
      ]
    }
  }
}
Run commandnpx -y oss-search

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmoss-search0.3.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

oss-mcp (npm distribution)

npm/npx distribution of oss-search — fast local + federated OSS code search and repo discovery, exposing 7 MCP tools over stdio plus a byte-identical CLI.

This package contains no compiled code and has zero runtime dependencies. On first run, the oss-mcp shim downloads the prebuilt Rust binary for your platform from GitHub Releases, verifies it against the release's checksums.txt (when present), and caches it. Subsequent runs start instantly from the cache.

Requirements

  • Node.js >= 18 (only to bootstrap the binary)
  • macOS (x64, arm64) or Linux (x64, arm64)
  • A published release v<version> with assets named oss-search-<version>-<target>.tar.gz (containing the oss-mcp binary) and, optionally, checksums.txt

Run once

npx oss-search            # speaks MCP over stdio
npx oss-search --live     # enable remote backends (GitHub code search, grep.app, deps.dev, ...)

Install globally

npm install -g oss-search
oss-mcp

Use with an MCP client

{
  "mcpServers": {
    "oss-search": {
      "command": "npx",
      "args": ["oss-mcp"]
    }
  }
}

Or point directly at the cached binary (~/.cache/oss-search/bin/<version>-<target>/oss-mcp) to skip the Node shim entirely.

Cache

Binaries are cached at ~/.cache/oss-search/bin/<version>-<target>/oss-mcp. Override the location with the OSS_SEARCH_CACHE_DIR environment variable. Delete the cache to force a re-download.

For GITHUB_TOKEN-backed live search and other options, see the repository README.

License

MIT — see LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.