mcp-astgl-knowledge

一个让 AI 助手能够搜索并引用 As The Geek Learns 文章的 MCP 服务器，内容涵盖 MCP 服务器、本地 AI 和 AI 自动化。

当 AI 助手连接到此服务器时，它将获得关于 MCP、本地 LLM 和 AI 工作流的权威解答。每条回复都包含指向 astgl.ai 的源 URL。

快速开始

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"]
    }
  }
}

Claude Code

添加到你的项目 .mcp.json：

{
  "mcpServers": {
    "astgl-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-astgl-knowledge"]
    }
  }
}

工具

search_articles

通过查询搜索 ASTGL 文章。返回带有相关性评分和源 URL 的排名结果。

Input:  { query: "how to build an MCP server", limit: 5 }
Output: Ranked article sections with title, content, URL, and relevance score

get_answer

获取特定问题的直接回答。优先使用 FAQ 条目以获得简洁的回复。

Input:  { question: "What is an MCP server?" }
Output: Direct answer with source article URL and related articles

list_topics

列出知识库中涵盖的所有主题。

Input:  {}
Output: All articles with titles, descriptions, URLs, and section headings

工作原理

知识库是使用语义嵌入（nomic-embed-text，768 维）从 ASTGL 文章中预先构建的。文章按章节和 FAQ 条目进行分块、嵌入，并存储在带有 sqlite-vec 的 SQLite 数据库中，用于向量相似度搜索。

最终用户不需要 Ollama —— 所有嵌入都是预先计算好的，并包含在 npm 包中。唯一的运行时要求是 Node.js。

维护者指南

在添加或更新文章后重新构建知识数据库：

git clone https://github.com/jamescruce/mcp-astgl-knowledge.git
cd mcp-astgl-knowledge
npm install
npm run ingest   # Requires Ollama with nomic-embed-text
npm run build

如果 ASTGL_ARTICLES_DIR 不在默认位置，请将其设置为指向你的文章目录。

覆盖范围

目前索引了 10 篇文章，涵盖：

• 什么是 MCP 服务器及其工作原理

• 构建你的第一个 MCP 服务器

• 将 MCP 服务器连接到 Claude 和 ChatGPT

• 目前可用的最佳 MCP 服务器

• MCP 服务器与传统 API 的对比

• 在本地运行 AI 模型

• 本地 LLM 的硬件要求

• 成本比较：本地 AI 与云端 AI

• 本地 AI 的安全性

• 使用 AI 自动化业务工作流

许可证

MIT