Skip to main content

timeverse-plugin-search

PyPI Python CI License

从 SkillHub、Smithery、MCP Registry、GitHub、魔搭社区、mcp.so、mcp.aibase.cn、mcpmarket.cn 及全网搜索等来源搜索可安装的技能包和 MCP 服务器的开放工具。

Tools

工具 描述
search_skills 从 SkillHub、AI Skill Store、GitHub、魔搭社区、mcp.so、全网搜索等来源搜索技能包
search_mcp_servers 从 Smithery、官方 MCP Registry、魔搭社区、mcp.so、mcp.aibase.cn、mcpmarket.cn、GitHub、全网搜索等来源搜索 MCP 服务器
list_sources 列出所有配置的数据源
get_plugin_detail 获取单个插件的详细信息

搜索策略

采用分层降级策略,默认只查快速源:

search_skills

层级 源 延时 默认是否启用
Tier 1 SkillHub, AI Skill Store ~1-2s ✅ 总是启用
Tier 2 GitHub, 魔搭社区 ~+1-2s ✅ 不足时自动降级
Tier 3 mcp.so, 全网搜索 ~+2-5s 🔲 深度模式或结果不足时

search_mcp_servers

层级 源 延时 默认是否启用
Tier 1 Smithery, 官方 Registry, 魔搭社区 ~1-2s ✅ 总是启用
Tier 2 GitHub ~+1-2s ✅ 不足时自动降级
Tier 3 mcp.so, mcp.aibase.cn, mcpmarket.cn, 全网搜索 ~+3-8s 🔲 深度模式或结果不足时

安装

pip install timeverse-plugin-search

或从源码安装:

git clone https://github.com/timeverse-studio/timeverse-plugin-search.git
cd timeverse-plugin-search
pip install -e ".[dev]"

使用

作为 CLI 工具

timeverse-plugin-search

与 TimeVerse Studio 集成

在 TimeVerse Studio 的 MCP Server 配置中通过 JSON 添加,可一并传入环境变量:

{
  "mcpServers": {
    "timeverse-plugin-search": {
      "command": "uvx",
      "args": ["timeverse-plugin-search"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "SOURCES_CONFIG": "{\"sources\":[{\"id\":\"glama\",\"name\":\"Glama.ai\",\"type\":\"rest_api\"}]}"
      }
    }
  }
}
字段 说明
command 启动命令,uvx 或 timeverse-plugin-search(pip 安装后)
args 传递给命令的参数
env (可选)传递给子进程的环境变量,优先级高于系统环境变量

env 字段中可设置的环境变量说明见下方配置章节。

配置

通过环境变量自定义配置:

# GitHub Token(提升 API 频率限制到 5000次/时)
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx

# 自定义数据源(合并模式)
SOURCES_CONFIG='{"sources":[{"id":"glama","name":"Glama.ai","type":"rest_api","enabled":true,"config":{"base_url":"https://glama.ai/api","endpoint":"/mcp/servers","query_param":"query"}}]}'

指定平台搜索

通过 source 参数可指定搜索平台:

用户: "帮我在 SkillHub 上搜一下翻译相关的技能包"
→ LLM 调用 search_skills(q="翻译", source="skillhub")

用户: "在官方 MCP Registry 上搜一下文件系统的"
→ LLM 调用 search_mcp_servers(q="filesystem", source="registry")

搜索深度

通过 depth 参数控制搜索范围:

  • "quick"(默认):仅查 REST API 源,快速返回
  • "deep":查所有源(含网页抓取和全网搜索),更全面

开发

pip install -e ".[dev]"
ruff check src/ tests/
ruff format src/ tests/
mypy src/
pytest -v

License

MIT

Metadata

Release files for timeverse-plugin-search 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for timeverse-plugin-search 0.1.1
File Size Uploaded Provenance
timeverse_plugin_search-0.1.1.tar.gz 15.3 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for timeverse-plugin-search 0.1.1
File Interpreter ABI Platform
timeverse_plugin_search-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 33.4 kB

Release files / timeverse_plugin_search-0.1.1.tar.gz

Download URL timeverse_plugin_search-0.1.1.tar.gz
Size 15.3 kB
Tags Source
SHA-256 checksum
How to use checksums
823cc509b85b4d769adbe24cea68d28fb2cb3bca6d32460abbb883893bfc76fa
BLAKE2b-256 checksum
How to use checksums
7359ad5a63b17d7b6528dcc10ef2a5d5c2740f932fd0062fa6e2d646dba0734a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 22, 2026.

Transparency log

Release files / timeverse_plugin_search-0.1.1-py3-none-any.whl

Download URL timeverse_plugin_search-0.1.1-py3-none-any.whl
Size 18.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a835e751dfd744839a44b1a10d91aaa6b1cc828715600364f03a81b5216855b8
BLAKE2b-256 checksum
How to use checksums
640f70cb2f055f439cb7a3a27673cb269963c79e91c26bb1a973793789011459
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 22, 2026.

Transparency log

Security for timeverse-plugin-search 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for timeverse_plugin_search-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page