Up-to-Date Docs MCP Server

이 워크스페이스에는 작업 중 프로젝트를 검사하고 알려진 문서 URL을 가져오기 위한 소형 MCP 서버가 포함되어 있습니다. 소프트웨어 저장소, 전자제품 폴더, 펌웨어, KiCad/PlatformIO/Arduino 작업, SPICE 파일, 데이터시트 중심 디버깅 등 혼합 프로젝트를 위해 설계되었습니다.

이 서버는 의도적으로 표준 라이브러리만 사용하는 Python으로 작성되어 npm install 없이 실행할 수 있습니다. Python 내장 HTTP 클라이언트를 먼저 사용하고, 로컬 Python 인증서 저장소가 없거나 오래된 경우 검증된 curl -L 가져오기로 대체합니다.

제공 기능

• analyze_project: 프로젝트 폴더에서 매니페스트, 의존성, 프레임워크, 펌웨어/전자제품 파일, 예상 문서 주제를 스캔합니다.

• fetch_doc: 문서 페이지 또는 데이터시트 URL을 가져와 읽을 수 있는 텍스트로 반환합니다. HTML은 기본적으로 작동합니다. PDF는 pypdf 또는 pdftotext가 설치되어 있으면 더 좋습니다.

• context7_search: 소프트웨어 라이브러리 문서에 대한 선택적 Context7 검색.

• context7_docs: 라이브러리 ID를 확인한 후의 선택적 Context7 문서 가져오기.

Related MCP server: GitHub Repo Explainer MCP

빠른 스모크 테스트

python3 up_to_date_docs_mcp.py --self-test

일반 MCP 구성

이 스크립트의 절대 경로를 사용하세요:

{
  "mcpServers": {
    "up-to-date-docs": {
      "command": "python3",
      "args": [
        "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"
      ],
      "env": {
        "DOCS_MCP_PROJECT_ROOT": "/path/to/your/current/project"
      }
    }
  }
}

up_to_date_docs_mcp.py를 docs_mcp_*.py 헬퍼 파일들과 같은 폴더에 유지하세요. 엔트리포인트는 런타임에 해당 모듈을 임포트합니다.

프로젝트별 설정을 원한다면 다음 중 하나를 수행하세요:

• MCP 클라이언트에서 서버 작업 디렉터리를 프로젝트 폴더로 설정하거나,

• 프로젝트를 전환할 때 DOCS_MCP_PROJECT_ROOT를 변경하거나,

• analyze_project 호출 시 path 인수를 전달하세요.

Codex 설정

Codex는 전역 구성에서 MCP 서버를 읽습니다. codex 명령이 PATH에 있으면 다음으로 서버를 등록하세요:

codex mcp add up-to-date-docs \
  --env DOCS_MCP_PROJECT_ROOT="/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS" \
  -- "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/.venv/bin/python" \
  "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"

터미널에 codex: command not found가 표시되면 ChatGPT 앱에 번들된 Codex CLI를 사용하세요:

/Applications/ChatGPT.app/Contents/Resources/codex mcp add up-to-date-docs \
  --env DOCS_MCP_PROJECT_ROOT="/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS" \
  -- "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/.venv/bin/python" \
  "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"

Codex가 이를 볼 수 있는지 확인하세요:

/Applications/ChatGPT.app/Contents/Resources/codex mcp list

서버를 추가한 후 새 Codex 세션을 시작하고 다음을 실행하세요:

/mcp

up-to-date-docs가 활성화된 MCP 서버로 표시되어야 합니다. 그런 다음 Codex에게 up-to-date-docs를 사용하여 프로젝트를 분석하거나 문서 URL을 가져오도록 요청하세요.

선택적 Context7

Context7은 라이브러리별로 문서가 인덱싱되어 있어 소프트웨어 라이브러리에 유용합니다. 이 서버는 Context7 없이도 작동하지만, 다음을 추가할 수 있습니다:

{
  "env": {
    "CONTEXT7_API_KEY": "your_key_here"
  }
}

그런 다음 context7_search를 먼저 사용하고 context7_docs를 이어서 사용하세요.

예시 프롬프트

• "이 프로젝트를 분석하고 주요 프레임워크에 대한 문서 주제를 제안해 줘."

• "이 데이터시트 URL을 가져와서 절대 최대 정격을 요약해 줘."

• "Context7을 사용하여 의존성 주입에 대한 최신 FastAPI 문서를 가져와 줘."

• "이 펌웨어 폴더를 분석하고 찾아볼 문서 주제를 제안해 줘."

참고 사항

• 서버는 URL이 주어지면 실제 웹 페이지를 가져오므로 MCP 클라이언트는 서버 프로세스에 네트워크 액세스를 허용해야 합니다.

• 일반 웹 검색은 신뢰할 수 있는 검색 백엔드가 생길 때까지 의도적으로 노출하지 않습니다.

• 최신 server/discover 흐름과 이전 initialize 흐름을 모두 지원하므로 다양한 MCP 클라이언트에서 작동합니다.

• PDF 추출은 선택 사항입니다. 전자제품 작업의 경우 pypdf 또는 Poppler의 pdftotext를 설치하면 데이터시트가 훨씬 유용해집니다.

• 로그는 stderr로 출력되므로 stdout은 MCP 프로토콜 메시지 전용으로 유지됩니다.