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 서버 vs 기존 API

• 로컬에서 AI 모델 실행하기

• 로컬 LLM을 위한 하드웨어 요구 사항

• 비용 비교: 로컬 vs 클라우드 AI

• 로컬 AI의 보안

• AI를 통한 비즈니스 워크플로우 자동화

라이선스

MIT