Priyadarshiswain/Sanjaya

# Sanjaya **代码库全景，证据驱动。** Sanjaya 为 AI agent 提供本地优先的代码库发现能力，支持精确的导航，并提供可验证的证据，例如相对于代码库的路径、符号以及行范围。 首个交付物是一个 .NET Model Context Protocol (MCP) 服务器。一个可移植的、证据优先的代码发现技能计划在后续版本中发布，当前的开发版本中暂不包含。 在《摩诃婆罗多》中，Sanjaya 能够感知到其他人无法直接看到的事件，并忠实地报告它们。本项目为 AI 编程 agent 扮演着类似的角色：帮助它们纵览整个代码库，并带着证据报告其发现。 ## 项目状态 Sanjaya 目前拥有一个可运行的开发版 MCP 服务器，但尚未正式发布。 它实现了能力报告、健康检查、有界的精确文本搜索、通用的可读文件大纲，以及有界的本地 Git 更改证据。 发现范围被限定为每个进程一个明确的 repository root。npm 包、MCP Registry 条目和安装命令目前尚不存在。 ## v0.1 方向 - .NET 8 stdio MCP server - npm 安装与启动通道 - 默认配置下无网络调用 - 由 Roslyn 提供支持的 C# 发现 - 针对 TypeScript 和 JavaScript 的 TypeScript compiler AST chunking - 针对其他可读语言的通用文件与精确文本功能 - 确定性的 repository-local 结构化索引 - 明确的能力与降级报告 有关拟议的公开契约，请参阅[功能](docs/capabilities.md)、[架构](docs/architecture.md)和[隐私](docs/privacy.md)。 ## 批准的 v0.1 MCP 工具 - `capabilities` - `health_check` - `file_outline` - `search_text` - `recent_changes` - `index_codebase` - `search_code` - `find_definition` - `find_references` - `get_source` 这些名称构成了已批准的 v0.1 契约。当前运行时注册了 `capabilities`、`health_check`、`file_outline`、`search_text` 和 `recent_changes`。在进程使用有效的 `--root ` 启动之前，发现工具会报告 `repository_root_required`；本地 Git 证据还要求该 root 必须是 Git worktree 根目录。所有其他已批准的工具均报告 `not_implemented`。 ## 开发 开发版本需要 .NET 8 SDK 和 Node.js 18 或更高版本。有关验证命令，请参阅[开发指南](docs/development.md)。 ## 许可证 Sanjaya 采用 [Apache License 2.0](LICENSE) 授权。分发的第三方组件保留其各自的许可证和声明。

标签：AI智能体, AST解析, MCP服务器, MITM代理, 代码分析, 代码搜索, 凭证管理