AI导哈

知识库AI技能服务

将个人知识库（书签、笔记、RSS订阅和图像生成）转化为AI代理可调用的技能，适用于各种AI代理平台。

  • by freeman983
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 freeman983/navhub-skills

使用说明

navhub-skills

Turn your NavHub personal knowledge base into AI agent skills.

中文文档 | English

navhub-skills exposes your bookmarks, notes, RSS feeds, and image generation as callable skills for any AI agent — compatible with the Model Context Protocol (MCP).

What is it?

NavHub is a personal navigation and knowledge management platform (bookmarks, notes, RSS, AI workspace). navhub-skills wraps NavHub's open API as a skill registry — a structured set of tools that AI agents can discover and call.

Your NavHub Data
  ├── Bookmarks  ──┐
  ├── Notes      ──┼──▶  navhub-skills  ──▶  Any AI Agent
  ├── RSS Feeds  ──┤         (MCP)            (Claude, GPT, etc.)
  └── Image Gen  ──┘

Built-in Skills

Skill Description Scopes Required
memory Read/write persistent notes across sessions notes:read, notes:write
bookmarks Search and manage your bookmark library bookmarks:read, bookmarks:write
rss Access your RSS feeds and articles rss:read
image-gen Generate images from text prompts image:generate

Quick Start

New here? Just add the server to your AI client without any key and ask it about NavHub — it will walk you through setup. The server never fails silently: with no key (or a bad one) it still starts, exposing a single navhub_setup tool that returns step-by-step instructions.

To check your connection from a terminal at any time:

npx navhub-skills

Run directly in a terminal it acts as a self-check and prints the connection status; launched by an AI client it runs as an MCP server. No flags needed.

1. Get your NavHub API Key

Log in to navhub.info → Enterprise → API Keys → Create new key.

The key looks like nhk_xxxxxxxx and is shown only once — copy it right away.

Select the scopes you need (notes:read, notes:write, bookmarks:read, etc.).

2. Discover available skills

curl https://navhub.info/open/v1/skills \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Get the MCP manifest

curl https://navhub.info/open/v1/mcp.json \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns a full MCP tool list — ready to use with any MCP-compatible client.

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "navhub": {
      "command": "npx",
      "args": ["-y", "navhub-skills"],
      "env": {
        "NAVHUB_API_KEY": "YOUR_API_KEY",
        "NAVHUB_BASE_URL": "https://navhub.info"
      }
    }
  }
}

Then ask Claude:

  • "Remember that the project deadline is March 15th"
  • "Search my bookmarks for React performance articles"
  • "Summarize today's unread articles from my RSS feeds"
  • "Generate a cover image for my blog post about AI"

API Reference

Authentication

All endpoints require an API key:

Authorization: Bearer nhk_xxxxxxxxxxxxxxxx

Skill Discovery

Endpoint Description
GET /open/v1/skills List skills accessible with your API key
GET /open/v1/skills/:name Get a single skill manifest
GET /open/v1/mcp.json Full MCP tool manifest

Memory Skill

Action Method Path Description
remember POST /open/v1/memory/notes Write a memory (Markdown supported)
recall GET /open/v1/memory/notes/search Search by keyword (?q=)
list GET /open/v1/memory/notes List memories (folder filter)
get GET /open/v1/memory/notes/:id Get a single memory
update PUT /open/v1/memory/notes/:id Update a memory
forget DELETE /open/v1/memory/notes/:id Delete a memory
graph GET /open/v1/memory/notes/graph Bi-directional link graph
folders GET /open/v1/memory/notes/folders List memory folders
links GET /open/v1/memory/notes/:id/links Get bi-directional links

Bookmarks Skill

Action Method Path Description
search GET /open/v1/bookmarks/search Search bookmarks (?q=, limit)
list GET /open/v1/bookmarks List bookmarks (tag/folder filter)
get GET /open/v1/bookmarks/:id Get a single bookmark
save POST /open/v1/bookmarks Save a new bookmark
update PUT /open/v1/bookmarks/:id Update a bookmark
delete DELETE /open/v1/bookmarks/:id Delete a bookmark

RSS Skill

Action Method Path Description
list_feeds GET /open/v1/rss/feeds List RSS subscriptions
list_articles GET /open/v1/rss/articles List articles (unread, starred)
search GET /open/v1/rss/articles/search Search articles by keyword
get_article GET /open/v1/rss/articles/:id Get full article content
mark_read PUT /open/v1/rss/articles/:id/read Mark as read
toggle_star PUT /open/v1/rss/articles/:id/star Star / unstar

Image Generation Skill

Action Method Path Description
generate POST /open/v1/image-gen Generate image from prompt
list_models GET /open/v1/image-gen/models List available models 
{
  "prompt": "a minimal bookmark icon on white background",
  "aspect_ratio": "1:1",
  "model": "flux-schnell",
  "num_images": 1
}

Available Scopes

Scope Access
bookmarks:read Read bookmarks
bookmarks:write Create / update / delete bookmarks
notes:read Read notes
notes:write Create / update / delete notes
rss:read Read RSS feeds and articles
rss:write Mark read, star articles
image:generate Generate images

Self-hosting

navhub-skills is built into NavHub. To self-host:

git clone https://github.com/shuaninfo/bookmark
cd bookmark
cp config/app.ini.example config/app.ini
make server

The skills API is available at http://localhost:8080/open/v1/.

Examples

See examples/ for:

  • Claude Desktop configuration
  • Full curl examples for every endpoint

Contributing

Issues and PRs welcome. To request a new skill, use the Skill Request template.

License

MIT

相关 MCP