mcpField
O
oss-search

oss-search

本地服务
github.com搜索与检索01 周前更新
代码仓库访问官网

关于 oss-search

oss-search 是用于本地及联邦式开源代码搜索和仓库发现的 MCP 服务，并提供对应命令行工具。它通过标准输入输出提供七种 MCP 工具，也可用 `--live` 启用远程后端。

主要功能

  1. 01本地开源代码搜索
  2. 02联邦式代码搜索
  3. 03发现代码仓库
  4. 04通过标准输入输出提供七种 MCP 工具
  5. 05对应的命令行工具
  6. 06缓存 Rust 二进制文件

适用场景

  1. 01在开源项目中查找代码
  2. 02发现相关代码仓库
  3. 03用 `--live` 搜索远程来源
  4. 04通过 MCP 或命令行进行搜索

MCP 相关

它通过标准输入输出向 MCP 客户端提供七种代码搜索和仓库发现工具。命令行工具提供相同功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "sblattj-oss-search": {
      "command": "npx",
      "args": [
        "-y",
        "oss-search"
      ]
    }
  }
}
启动命令npx -y oss-search

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmoss-search0.3.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

oss-mcp（npm 分发版）

oss-search 的 npm/npx 分发版 — 快速的本地与联合式 OSS 代码搜索和仓库发现工具，通过 stdio 提供 7 个 MCP 工具，并附带一个字节完全一致的 CLI。

此软件包不包含编译后的代码，且没有任何运行时依赖。首次运行时，oss-mcp shim 会从 GitHub Releases 下载适用于你平台的预构建 Rust 二进制文件，在存在 checksums.txt 时对其进行校验，并将其缓存。后续运行会直接从缓存启动，即时运行。

要求

  • Node.js >= 18（仅用于引导二进制文件）
  • macOS（x64、arm64）或 Linux（x64、arm64）
  • 已发布的 v<version> 版本，包含名为 oss-search-<version>-<target>.tar.gz（其中包含 oss-mcp 二进制文件）的资源，以及可选的 checksums.txt

运行一次

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

全局安装

npm install -g oss-search
oss-mcp

与 MCP 客户端配合使用

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

或者直接指向缓存的二进制文件（~/.cache/oss-search/bin/<version>-<target>/oss-mcp），完全跳过 Node shim。

缓存

二进制文件缓存在 ~/.cache/oss-search/bin/<version>-<target>/oss-mcp。使用 OSS_SEARCH_CACHE_DIR 环境变量覆盖缓存位置。删除缓存即可强制重新下载。

有关由 GITHUB_TOKEN 支持的实时搜索和其他选项，请参阅仓库 README。

许可证

MIT — 参见 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。