Nia 文档搜索(nia-docs)用于通过 Nia 搜索库文档和代码示例。
用途 该工具面向需要快速查找第三方库文档与代码示例的场景,支持跨 3000 多个包(npm、PyPI、Crates、Go)以及已索引来源进行检索。
主要能力
- 在指定包内进行语义搜索。
- 按特定注册表搜索,注册表可选 npm、py_pi、crates、go_modules,默认 npm。
- 使用正则表达式进行 grep 搜索,以查找特定模式。
- 跨所有已索引来源进行通用搜索。
- 可通过 --limit 控制返回结果数量,默认 5。
使用方式
通过 uv 运行 Python 脚本,基本命令形式为:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package fastapi --query "dependency injection"
指定注册表:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package react --registry npm --query "hooks patterns"
Grep 搜索:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package sqlalchemy --grep "session.execute"
通用搜索:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--search "error handling middleware"
选项 --package:要搜索的包名。 --registry:注册表,可选 npm、py_pi、crates、go_modules,默认 npm。 --query:语义搜索查询。 --grep:要搜索的正则表达式模式。 --search:跨所有已索引来源的通用搜索。 --limit:最大结果数,默认 5。
示例
Python 库用法:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package pydantic --registry py_pi --query "validators"
React 模式:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package react --query "useEffect cleanup"
查找特定函数用法:
uv run python -m runtime.harness scripts/mcp/nia_docs.py
--package express --grep "app.use"
适用场景 适用于开发过程中查询库文档、查找代码示例、检索特定函数或模式用法,以及跨多个包和来源进行统一搜索。
限制 需要在环境中配置 NIA_API_KEY,或在 mcp_config.json 中配置 nia 服务器。其他限制暂未提供。