Nix Search Net

尼克斯搜索。网

一个全面的。NET解决方案，用于使用search.NixOS.org Elasticsearch后端搜索和探索NixOS包、选项和薄片。

 

概述

尼克斯搜索。NET提供了多种与NixOS软件包和选项搜索生态系统交互的方法：

• 图书馆：稳健。NET客户端库，用于程序化访问
• CLI工具：用于快速搜索的命令行界面
• MCP服务器：用于AI辅助集成的模型上下文协议服务器

项目

尼克斯搜索。核心

核心库为NixOS软件包、选项和薄片提供搜索功能。

• NuGet包: NixSearch.Core
• 目标框架: .净值10
• 特性：完全支持Elasticsearch查询、强类型模型、异步/等待模式

尼克斯搜索。命令行界面

一个命令行工具，用于从终端搜索NixOS软件包和选项。

• NuGet包: NixSearch.CLI
• 工具命令: nixsearch
• 安装: dotnet tool install -g NixSearch.CLI

尼克斯搜索。主控程序

模型上下文协议（MCP）服务器，使AI助手能够搜索NixOS包和选项。

• NuGet包: NixSearch.MCP
• 部署：AWS Lambda（ARM64）
• 协议: 模型上下文协议

快速开始

使用图书馆

dotnet add package NixSearch.Core

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

using NixSearch.Core.Extensions;
using NixSearch.Core.Models;
using NixSearch.Core.Search;

IConfiguration configuration = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .Build()
    .GetSection("NixSearch");

ServiceCollection services = new ServiceCollection();
services.AddNixSearch(configuration);
ServiceProvider provider = services.BuildServiceProvider();

INixSearchClient client = provider.GetRequiredService();
IReadOnlyList channels = await client.GetChannelsAsync();

Nest.ISearchResponse results = await client.Packages()
    .WithQuery("git")
    .ForChannel(NixChannel.Parse("unstable", channels))
    .Page(0, 10)
    .ExecuteAsync();

foreach (NixPackage package in results.Documents)
{
    Console.WriteLine($"{package.Name}: {package.Version}");
}

使用CLI

# Install globally
dotnet tool install -g NixSearch.CLI

# Search for packages
nixsearch packages git --size 10

# Search for options
nixsearch options services.nginx --size 5

使用MCP服务器

MCP服务器可以部署到AWS Lambda或在本地运行。看 MCP文件 了解与Claude等人工智能助手集成的详细信息。

建筑

# Build all projects
dotnet build

# Run tests
dotnet test

# Pack NuGet packages
dotnet pack

需求

• .NET 10 SDK或更高版本
• 对于AWS Lambda部署：已配置AWS CLI

仓库结构

NixSearch.NET/
├── src/
│   ├── NixSearch.Core/      # Core library
│   ├── NixSearch.CLI/       # CLI tool
│   └── NixSearch.MCP/       # MCP server
├── tests/
│   ├── NixSearch.Core.Tests/
│   ├── NixSearch.CLI.Tests/
│   └── NixSearch.MCP.Tests/
├── .github/
│   └── workflows/           # CI/CD workflows
└── NixSearch.sln            # Solution file

贡献

欢迎投稿！请随时提交问题或拉取请求。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 建在 search.nixos.org 基础设施
• 用途 巢 用于Elasticsearch集成
• MCP协议实现 模型上下文协议