mcp-astgl-knowledge

As The Geek Learns の記事（MCPサーバー、ローカルAI、AI自動化に関する内容）をAIアシスタントが検索・引用できるようにするMCPサーバーです。

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 vs クラウドAI

• ローカルAIのセキュリティ

• AIによるビジネスワークフローの自動化

ライセンス

MIT