Context Book

Name: Context Book
Author: aditya201551

作者：aditya201551版本 1.0.2i★ –i在云端运行

注册名称io.github.aditya201551/context-book-mcp

安装

概览

作者提供的说明（英文原文）

Stop re-explaining yourself to Agents. Give it the right context, right when needed.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i非常新★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在云端运行
传输方式: Streamable HTTP
分类: 其他

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
注册中心没有列出需要填写的密钥。

你需要

在云端运行无需安装任何东西，通过互联网连接

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude：

打开 Settings → Connectors
点击 Add custom connector
粘贴下面的地址，然后点击 Add
如果要求登录，请登录作者的服务

https://context-book-mcp-production.up.railway.app

在终端中运行这条命令

claude mcp add --transport http context-book https://context-book-mcp-production.up.railway.app

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "context-book": {
      "url": "https://context-book-mcp-production.up.railway.app"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "context-book": {
      "type": "http",
      "url": "https://context-book-mcp-production.up.railway.app"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

ChatGPT 只能连接互联网上的服务器：

打开网页版 ChatGPT → Settings → Connectors (Apps)
点击 Create 或 Add（部分套餐需要先在 Advanced 中开启 Developer mode）
粘贴下面的地址，起个名字，然后保存
如果要求登录，请登录作者的服务

https://context-book-mcp-production.up.railway.app

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

我们还没有读取这个服务器的工具列表；我们会轮流检查各个端点。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 aditya201551 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
… 尚未检查
端点有响应
尚未检查；我们会轮流检查各个端点
… 尚未检查
使用 OAuth 登录
尚未检查；我们会轮流检查各个端点
… 尚未检查
工具描述中没有隐藏指令
尚未检查；我们会在检查端点时读取工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 18475 个服务器的 0%
发布到注册中心的时间比此分类中其他 18475 个服务器的 8% 更新
基础检查结果等于或优于此分类中其他 18475 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Context Book 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.0.2）于6个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Tethered Trust

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

作者：formulahendry起步阶段↓ 66/周★ 44014个月前更新

在你的电脑上运行

安装

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

作者：desktop-commander正在增长★ 2113天前更新

在云端运行✓ desktopcommander.app

安装

Tethered Trust

Fit, compatibility and recall checks for AI agents before they buy: verdicts, evidence, receipts.

作者：tetheredtrust.com非常新今天更新

在云端运行✓ tetheredtrust.com

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Stop re-explaining yourself to Agents. Give it the right context, right when needed.

LLMs are stateless — each conversation starts from scratch. ContextBook gives your AI tools a persistent, searchable knowledge library to draw the right context when they need it. No bloatware, no pre-loaded junk. Just the right information, at the right time.

How It Works

flowchart LR

AI["🤖 AI Clients\nClaude · Cursor · Windsurf"] Browser["🌐 Browser Dashboard"] MCP["🔌 MCP Server :8081\n8 Bearer-authenticated tools"] API["⚙️ REST API :8080\nOAuth 2.0 · Books · Pages · Search"] DB["🗄️ PostgreSQL\npgvector · pg_trgm"] VOYAGE["🧠 Voyage AI\nvoyage-4 (1024-dim)"]

AI -- "MCP · Bearer Token" --> MCP Browser -- "Session · HTTP JSON" --> API MCP --- DB API --- DB API -- "OAuth 2.0 PKCE" --> AI DB --- VOYAGE

Two Go binaries share a PostgreSQL database:

API server (cmd/api) — the control plane: user login, OAuth 2.0, dashboard, book/page CRUD
MCP server (cmd/mcp) — the data plane: 8 MCP tools for AI agents, protected by Bearer tokens

MCP Tools

All tools require a valid Bearer token and are scoped to the authenticated user.

Tool	Description
`book_create_or_update`	Create a Book or update its metadata
`book_list`	Paginated list of Book metadata
`book_get`	Retrieve all pages of a Book
`page_insert`	Push an atomic page into a Book; embeds immediately
`page_update`	Replace a page's content; re-embeds
`page_delete`	Remove a page (indices not re-numbered)
`page_search`	Semantic search across all Books
`readme`	Returns the usage guide (call once per session)

Quick Start

Prerequisites

Go 1.26+
Node.js 22+
PostgreSQL 16+ with pgvector and pg_trgm
A Voyage AI API key

1. Set up the database

CREATE DATABASE contextbook_db;

\c contextbook_db CREATE EXTENSION IF NOT EXISTS vector; CREATE EXTENSION IF NOT EXISTS pg_trgm;

Migrations run automatically on API server startup.

2. Configure environment

cp .env.example backend/.env

Edit backend/.env — set DATABASE_URL, API_KEY_SALT, VOYAGE_API_KEY

3. Run the backend

cd backend

go run ./cmd/api/main.go # API + dashboard (:8080) go run ./cmd/mcp/main.go # MCP server (:8081)

4. Run the frontend (optional)

cd frontend

npm install && npm run dev # Vite dev server on :5173

5. Connect an AI client

For Cursor (.cursor/mcp.json):

"mcpServers": { "contextbook": { "url": "http://localhost:8081/mcp" } } }

For any MCP-compatible client, point the server URL to http://localhost:8081/mcp.

Documentation

Backend README — API routes, auth flows, database schema, MCP tools, configuration
Frontend README — components, routing, design system, development setup
Architecture — full system overview with Mermaid diagrams

Project Structure

context-book/

├── backend/ │ ├── cmd/api/main.go REST API + auth server │ ├── cmd/mcp/main.go MCP tool server │ └── internal/ │ ├── api/ REST handlers + routes │ ├── auth/ OAuth 2.0 PKCE, sessions, SSO │ ├── context/ Book/Page business logic │ ├── db/ pgx queries + migrations │ ├── embedding/ Voyage AI client │ ├── logger/ slog + HTTP access logging │ └── mcp/ 8 MCP tool handlers ├── frontend/ React 19 + Vite + TypeScript SPA │ └── src/ │ ├── App.tsx Router + app shell │ ├── lib/api.ts HTTP client │ └── components/ UI components ├── Dockerfile API server container ├── Dockerfile.mcp MCP server container └── go.work Go workspace

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/my-feature)
Make your changes
Ensure the backend compiles (cd backend && go build ./cmd/api ./cmd/mcp)
Ensure the frontend builds (cd frontend && npm run build)
Commit and push
Open a Pull Request

License

MIT — see the LICENSE file for details.