solograph (Fortunto2)

独奏家

Claude Code的代码智能MCP服务器。多项目代码图、语义搜索、会话历史、知识库、网络搜索。

PyPI： pip install solograph / uvx solograph

全矢量搜索由 FalkorDB 的 （嵌入式，无Docker）。不依赖ChromaDB。

嵌入

两个后端，都生产 384维度 矢量：

自动检测苹果硅→ 使用MLX。回到其他平台上的句子转换器。

安装MLX支架（可选）：

uv add solograph[mlx]

安装

uv add solograph
# or
pip install solograph

用法

MCP服务器（用于克劳德代码）

claude mcp add -s project solograph -- uvx solograph

或手动添加到 .mcp.json:

{
  "mcpServers": {
    "solograph": {
      "command": "uvx",
      "args": ["solograph"]
    }
  }
}

命令行界面

solograph-cli init ~/my-projects       # First-time setup (scan + build graph)
solograph-cli init ~/my-projects --deep # + imports, calls, inheritance
solograph-cli scan                     # Re-scan projects into graph
solograph-cli scan --deep              # + imports, calls, inheritance (tree-sitter)
solograph-cli stats                    # Graph statistics
solograph-cli explain my-app           # Architecture overview
solograph-cli xray ~/my-projects       # Portfolio X-Ray (all projects at once)
solograph-cli diagram my-app           # Mermaid diagram
solograph-cli query "MATCH (n) RETURN n LIMIT 5"
solograph-cli web-search "query"       # Web search via SearXNG/Tavily
solograph-cli index-youtube -c GregIsenberg -n 10  # Index YouTube channel
solograph-cli index-youtube -u "https://youtube.com/watch?v=ID"  # Index specific video by URL
solograph-cli index-youtube             # Index all channels from channels.yaml

全局安装：

uv tool install solograph              # → solograph + solograph-cli in PATH

快速开始

# 1. Install
uv tool install solograph

# 2. Init — creates ~/.solo/, scans projects, builds graph
solograph-cli init ~/my-projects

# 3. Add MCP to Claude Code
claude mcp add -s project solograph -- uvx solograph

# 4. Done — MCP tools available in Claude Code

配置

环境变量：

15个MCP工具

• codegraph_query --针对代码图的密码查询
• codegraph_stats --图形统计（项目、文件、符号、包）
• codegraph_explain --项目架构概述
• codegraph_shared --跨项目共享的包
• project_code_search --语义代码搜索（首次调用时自动索引）
• project_code_reindex --将项目代码重新索引到FalkorDB向量中
• session_search --Claude Code会话历史记录搜索
• project_info --项目注册表信息
• kb_search --知识库语义搜索
• web_search --网络搜索（Tavily/SearXNG）
• source_search --搜索索引外部源（YouTube、Telegram）
• source_list --列出带有文档计数的索引源
• source_tags --自动检测带有视频计数的主题
• source_related --通过共享标签查找相关视频

网络搜索

这 web_search 工具连接到任何 旅居兼容API.非常适合自托管 SearXNG+Tavily适配器 -私有，没有API密钥，智能引擎路由。

# Self-hosted (Docker, 1 minute setup)
git clone https://github.com/fortunto2/searxng-docker-tavily-adapter.git
cd searxng-docker-tavily-adapter
cp config.example.yaml config.yaml
docker compose up -d
# → http://localhost:8013/search (Tavily API)
# → http://localhost:8999 (SearXNG UI)

或使用 美味API 直接设置 TAVILY_API_URL=https://api.tavily.com 和 TAVILY_API_KEY.

智能引擎路由根据查询类型自动选择搜索引擎：

• 技术：github、stackoverflow（关键字：python、react、code）
• 学术：arxiv，谷歌学者（关键词：研究，论文）
• 产品：勇敢、reddit、应用商店（关键词：应用、竞争对手、定价）
• 新闻：谷歌新闻（关键词：新闻、最新、趋势）
• 通用：谷歌、鸭子、勇敢（默认）

图形架构

节点

边缘

密码查询示例

-- Hub files (most imported)
MATCH (f:File)(pkg:Package) p2.name
RETURN pkg.name, COLLECT(DISTINCT p1.name) AS projects

-- Impact analysis: what breaks if I change this file?
MATCH (f:File {path: 'lib/utils.ts'})(f:File)
RETURN f.path, COUNT(s) AS sessions
ORDER BY sessions DESC LIMIT 10

-- Files touched by sessions in a project
MATCH (s:Session {project_name: 'my-app'})-[r]->(f:File)
RETURN f.path, type(r) AS action, COUNT(s) AS times
ORDER BY times DESC

YouTube源代码图

单独的FalkorDB图位于 ~/.solo/sources/youtube/graph.db:

索引器： solograph-cli index-youtube --通过SearXNG发现视频，通过yt-dlp获取元数据+VTT，按章节分组，嵌入，上传到图形中。

频道： ~/.solo/sources/youtube/channels.yaml --要索引的YouTube句柄的YAML列表。来自您项目的Symlink channels.yaml.

Chunking： VTT字幕解析为带时间戳的片段，通过以下方式按章节边界分组 chunk_segments_by_chapters().每个块都有精确的 start_seconds 根据真实的VTT时间戳。

VTT缓存： ~/.solo/sources/youtube/vtt/{videoId}.vtt --持久化，在重新索引时重用。

ProductHunt源代码图

单独的FalkorDB图位于 ~/.solo/sources/producthunt/graph.db:

索引器： solograph-cli index-producthunt -抓取ProductHunt GraphQL API v2，将产品映射到SourceDoc，并将支持率作为受欢迎程度。

solograph-cli index-producthunt -d 30            # Last 30 days
solograph-cli index-producthunt --all --resume    # Full 3-year dump with checkpoint
solograph-cli import-producthunt data.jsonl       # Import from JSONL file

排名： 搜索结果因受欢迎程度（赞成票）而增加。在语义相关性相同的情况下，获得更多支持的产品排名更高。

搜索服务器

用于在所有索引源中进行矢量搜索的HTTP API。设计为与SearXNG一起作为Docker服务运行。

# Standalone
solograph-search  # starts on port 8002

# Docker (in searxng-docker-tavily-adapter)
docker compose up -d solograph-search

终点：

• GET /search?q=AI+tool&source=producthunt&n=5 --语义搜索（源可选）
• GET /sources --列出带有计数的索引源
• GET /health --状态

人气提升： 获得更多支持的产品在同等相关性下排名更高。得分= cosine_similarity * 0.85 + log10(upvotes) * boost.获取3个候选人，重新排名，返回前N。

存储

• 代码图： ~/.solo/codegraph.db （FalkorDB）
• 会话向量： ~/.solo/sessions/graph.db （FalkorDB）
• KB向量： {KB_PATH}/.solo/kb/graph.db （FalkorDB）
• 项目向量： {project_path}/.solo/vectors/graph.db （根据FalkorDB项目）
• YouTube来源： ~/.solo/sources/youtube/graph.db （FalkorDB） + youtube/vtt/ （缓存的VTT文件）+ youtube/channels.yaml
• ProductHunt来源： ~/.solo/sources/producthunt/graph.db （FalkorDB）-26000多种产品，排名靠前

Solo工厂的一部分

一起安装技能+MCP：

# Option 1: Skills for any agent (Claude Code, Cursor, Copilot, Gemini CLI, etc.)
npx skills add fortunto2/solo-factory --all

# Option 2: Claude Code plugin (skills + agents + MCP auto-start)
claude plugin marketplace add fortunto2/solo-factory
claude plugin install solo --scope user

或者单独使用solograph——只需添加到 .mcp.json 如上所示。

许可证

麻省理工学院