timeverse-plugin-search
从 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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| timeverse_plugin_search-0.1.1.tar.gz | 15.3 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.