MCP 服务器

TrueSource GEO MCP Server

Enables AI assistants to audit websites for AI-readiness, generate AI-optimized robots.txt and llms.txt files, and create VibeTags for emotional AI brand resonance.

README

TrueSource GEO MCP Server

AI-Readiness auditing as an MCP tool surface — for Claude Desktop, Cursor, VS Code Copilot, and 70+ other MCP clients.

What is this?

This is a Model Context Protocol (MCP) server that exposes TrueSource's GEO-Audit methodology as standardized tools. Any MCP-compatible AI assistant can:

Audit websites for AI-readiness (robots.txt, llms.txt, schema markup, E-E-A-T signals)
Generate GEO files (AI-optimized robots.txt, llms.txt)
Create VibeTags for emotional AI brand resonance
Check robots.txt for AI bot allow/block status

Quick Start

Option A: npx (Recommended)

⚠️ The -y flag is critical — without it, npx silently waits for install confirmation in the background and the server freezes.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "truesource": {
      "command": "npx",
      "args": ["-y", "truesource-geo-mcp"],
      "env": {
        "TRUESOURCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code

Add to .cursor/mcp.json or VS Code MCP settings:

{
  "mcpServers": {
    "truesource": {
      "command": "npx",
      "args": ["-y", "truesource-geo-mcp"],
      "env": {
        "TRUESOURCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option B: Local Build

cd packages/geo-mcp
npm install
npm run build

{
  "mcpServers": {
    "truesource-geo": {
      "command": "node",
      "args": ["/absolute/path/to/packages/geo-mcp/build/index.js"],
      "env": {
        "TRUESOURCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Your MCP Host & Use

Ask your AI assistant:

"What's the AI-readiness score for my-website.com?"
"Generate a robots.txt for https://example.com"
"Check which AI bots are blocked on competitor.com"
"Create VibeTags for our brand at my-website.com"

Available Tools

Tool	Trigger	Description
`geo_score`	"audit", "score", "check AI readiness"	Full AI-readiness audit → 0-100 score, grade, checks, recommendations
`geo_inject`	"generate robots.txt", "create llms.txt"	Generate AI-optimized robots.txt + llms.txt (ready to deploy)
`vibetags_generate`	"brand perception", "VibeTags", "how AI sees"	Emotional AI brand resonance analysis (4-layer VibeGap Bridge)
`geo_check_robots`	"robots.txt", "which bots blocked"	Quick robots.txt AI bot status check (9 bots)

Environment Variables

Variable	Required	Default	Description
`TRUESOURCE_API_KEY`	Yes	—	API key for Railway backend authentication
`TRUESOURCE_API_URL`	No	Railway production URL	GEO-Inject API base URL
`TRUESOURCE_TIMEOUT`	No	`30000`	Request timeout in ms (MCP hosts timeout at ~60s)

Testing with MCP Inspector

npm run inspect

This opens the interactive MCP Inspector at http://localhost:6274, where you can:

See all registered tools and their schemas
Invoke tools with test data
Inspect JSON-RPC request/response pairs

Architecture

┌─────────────────────────────┐
│  MCP Host (Claude Desktop)  │
│  User: "Audit example.com"  │
└─────────────┬───────────────┘
              │ Stdio (JSON-RPC 2.0)
              ▼
┌─────────────────────────────┐
│  truesource-geo-mcp v1.2.0  │
│  (TypeScript MCP Server)    │
│                             │
│  Tools:                     │
│  ├── geo_score              │
│  ├── geo_inject             │
│  ├── vibetags_generate      │
│  └── geo_check_robots       │
└─────────────┬───────────────┘
              │ HTTPS + Bearer Auth
              ▼
┌─────────────────────────────┐
│  Railway API                │
│  (FastAPI / Python)         │
│  truesource-mcp-api         │
│                             │
│  POST /audit/robust         │
│  POST /activate/robots      │
│  POST /activate/llms        │
│  POST /semantize            │
│  GET  /check/robots         │
└─────────────────────────────┘

Changelog

v1.2.0 (2026-03-29) — Gemini Review Release

Security: API key authentication (Bearer token via TRUESOURCE_API_KEY)
Performance: Timeout reduced 180s → 30s (MCP host compatibility)
Performance: HTML streaming with </head> early-abort for Schema/OG checks
DX: Improved tool descriptions with explicit trigger words for better LLM routing
DX: npx -y install flow documented (prevents silent freeze)