Mcp Astgl Knowledge — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Mcp Astgl Knowledge (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
An MCP server that lets AI assistants search and cite content from As The Geek Learns — covering MCP servers, local AI, AI automation, and ASTGL project documentation.
When an AI assistant connects to this server, it gains access to 49 indexed entries (articles, tutorials, comparisons, guides, and project docs). Every response includes source URLs back to astgl.ai.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"astgl-knowledge": {
"command": "npx",
"args": ["-y", "mcp-astgl-knowledge"]
}
}
}Add to your project's .mcp.json:
{
"mcpServers": {
"astgl-knowledge": {
"command": "npx",
"args": ["-y", "mcp-astgl-knowledge"]
}
}
}{
"mcpServers": {
"astgl-knowledge": {
"command": "npx",
"args": ["-y", "mcp-astgl-knowledge"]
}
}
}Register via the register tool to get an API key, then add it to your config:
{
"mcpServers": {
"astgl-knowledge": {
"command": "npx",
"args": ["-y", "mcp-astgl-knowledge"],
"env": {
"ASTGL_API_KEY": "astgl_your_api_key_here"
}
}
}
}search_articlesSearch the knowledge base by query. Returns ranked results with relevance scores and source URLs.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query (e.g., "how to build an MCP server") |
limit | number | No | Max results, 1-20 (default: 5) |
content_type | string | No | Filter by type: article, tutorial, faq, comparison, guide, newsletter, project |
get_answerGet a direct answer to a specific question. Prefers FAQ entries for concise responses.
| Parameter | Type | Required | Description |
|---|---|---|---|
question | string | Yes | A specific question (e.g., "What is an MCP server?") |
content_type | string | No | Filter by content type |
get_tutorialGet step-by-step instructions from tutorial and guide content.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | What you want to learn (e.g., "setup Ollama on Mac") |
compare_topicsSide-by-side comparison of two topics.
| Parameter | Type | Required | Description |
|---|---|---|---|
topic_a | string | Yes | First topic |
topic_b | string | Yes | Second topic |
get_latestGet the most recently added content.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results, 1-20 (default: 5) |
list_topicsBrowse all topics in the knowledge base with content types and section headings.
registerRegister your email to unlock 500 queries/day (up from 50).
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Your email address |
| Type | Count | Description |
|---|---|---|
| article | 29 | Informational content about MCP, local AI, automation |
| project | 9 | ASTGL project documentation (KlockThingy, Revri, Cortex, etc.) |
| tutorial | 8 | Step-by-step how-to guides |
| comparison | 2 | Side-by-side topic analysis |
| guide | 1 | Comprehensive reference material |
| newsletter | — | Personal updates and announcements |
| faq | — | Primarily Q&A content |
| Tier | Limit | How to Get |
|---|---|---|
| Public | 50 queries/day | Default (anonymous) |
| Registered | 500 queries/day | Use the register tool with your email |
Limits reset at midnight UTC. Rate limit info is included in every response.
The knowledge base is pre-built from ASTGL articles using semantic embeddings (nomic-embed-text, 768 dimensions). Content is chunked by section and FAQ entry, embedded, and stored in a SQLite database with sqlite-vec for vector similarity search.
End users don't need Ollama — all embeddings are pre-computed and shipped in the npm package. The only runtime requirement is Node.js.
git clone https://github.com/Jmeg8r/mcp-astgl-knowledge.git
cd mcp-astgl-knowledge
npm install| Script | Description |
|---|---|
npm run build | Compile TypeScript |
npm run dev | Run MCP server in dev mode (tsx) |
npm start | Run compiled MCP server |
npm run ingest | Rebuild knowledge.db from local markdown (requires Ollama) |
npm run ingest-projects | Index project docs from astgl-site projects.json |
npm run discover | Poll RSS/sitemap for new content |
npm run structure | Process discovered content (classify, embed, index) |
npm run pipeline | Discover + structure in one step |
npm run daily-report | Generate AEO analytics report |
npm run alerts | Run content gap alert checks |
npm run freshness | Check for stale content and ecosystem version changes |
npm run citation-test | Manual AI citation testing |
npm run related | Generate internal article links via vector similarity |
| Variable | Default | Description |
|---|---|---|
OLLAMA_URL | http://localhost:11434 | Ollama endpoint (dev/rebuild only) |
EMBED_MODEL | nomic-embed-text | Embedding model |
DISCORD_WEBHOOK_URL | — | Discord webhook for reports/alerts |
ASTGL_API_KEY | — | Registered tier API key |
ASTGL_ARTICLES_DIR | ~/Projects/astgl-site/src/content/answers | Local markdown source |
ASTGL_PROJECTS_JSON | ~/Projects/astgl-site/src/data/projects.json | Projects data source |
| Job | Schedule | Purpose |
|---|---|---|
| Content pipeline | Every 6h | Discover + structure new content |
| Daily report | 8 AM | Query analytics + health metrics → Discord |
| Content alerts | 9 AM | Gap detection, zero-citation, competitor scan → Discord |
| Freshness check | 10 AM | Stale content + ecosystem version tracking → Discord |
MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.