{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nv4fyv5tnje8","handle":"iflow-mcp-the0807-geeknews-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-the0807-geeknews-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-the0807-geeknews-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-the0807-geeknews-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-the0807-geeknews-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-the0807-geeknews-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-the0807-geeknews-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_the0807-geeknews-mcp-server","summary":"GeekNews MCP Server - 从GeekNews获取文章的MCP服务器","description":"# GeekNews MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@the0807/geeknews-mcp-server)](https://smithery.ai/server/@the0807/geeknews-mcp-server)\n\n이 프로젝트는 [GeekNews](https://news.hada.io)에서 아티클을 가져오는 Model Context Protocol(MCP) 서버입니다. Python으로 구현되었으며, BeautifulSoup을 사용하여 웹 스크래핑을 수행합니다. 서버 부하를 줄이기 위해 하루에 한 번 자동으로 데이터를 파싱하고 캐시에 저장하는 기능을 제공합니다.\n\n## 기능\n|![tool1](img/tool1.png)    |![tool2](img/tool2.png)    |\n|:-------------------------:|:-------------------------:|\n|![example](img/example1.png)|![example](img/example2.png)|\n\n### 도구 (Tools)\n\n- `get_articles` 도구: GeekNews에서 아티클을 가져오는 기능\n  - 아티클 유형(top, new, ask, show)과 반환할 아티클 수를 지정할 수 있음\n  - 각 응답에는 제목, URL, 포인트, 작성자, 시간, 댓글 수, 순위 정보가 포함됨\n  - 캐시된 데이터를 사용하여 서버 부하 감소\n\n- `get_weekly_news` 도구: GeekNews에서 주간 뉴스를 가져오는 기능\n  - 특정 주간 뉴스 ID를 지정하거나 가장 최근 주간 뉴스를 가져올 수 있음\n  - 주간 뉴스의 제목, 번호, ID, 내용, URL, 아이템 목록 등의 정보를 제공\n  - 각 아이템에는 제목, URL, 순위 정보가 포함됨\n  - 캐시된 데이터를 사용하여 서버 부하 감소\n\n### 캐시 기능\n\n- 하루에 한 번 자동으로 데이터를 파싱하고 캐시에 저장\n- 캐시된 데이터가 유효한 경우 GeekNews 서버에 요청하지 않고 캐시된 데이터 사용\n- 캐시 데이터는 24시간 동안 유효하며, 이후 자동으로 갱신\n- 스케줄러가 주기적으로 캐시 유효성을 검사하고 필요시 갱신\n\n## 사용법\n\n- Smithery를 이용한 설치\n\n   🚀 [geeknews-mcp-server](https://smithery.ai/server/@the0807/geeknews-mcp-server)\n\n- MCP 설정 파일에 서버 정보를 추가\n\n   ```json\n   {\n   \"mcpServers\": {\n      \"geeknews-mcp-server\": {\n         \"command\": \"npx\",\n         \"args\": [\n         \"-y\",\n         \"@smithery/cli@latest\",\n         \"run\",\n         \"@the0807/geeknews-mcp-server\",\n         \"--key\",\n         \"smithery에서 발급 받은 키\"\n         ]\n      }\n   }\n   }\n   ```\n\n## 로컬 설치 방법\n\n1. Git Clone\n\n   ```bash\n   git clone https://github.com/the0807/GeekNews-MCP-Server\n   cd GeekNews-MCP-Server\n   ```\n\n2. uv로 환경 세팅\n\n   ```bash\n   uv sync\n   ```\n\n3. 가상환경 실행\n\n   ```bash\n   uv venv\n   source .venv/bin/activate\n   ```\n\n4. MCP Inspector로 서버 테스트\n\n   ```bash\n   uv run mcp\n   mcp dev main.py\n\n   # 터미널에 나오는 URL(MCP Inspector)로 접속하여 서버 테스트\n   ```\n\n## 코드 구조\n\n- `src/models.py`: 아티클 정보를 저장하는 데이터 클래스 정의\n- `src/parser.py`: GeekNews 웹사이트의 HT…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_the0807-geeknews-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_the0807-geeknews-mcp-server","registry":"pypi","observedAt":"2026-09-15T20:21:28.668Z","publishedAt":"2026-02-10T23:58:58.683669Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_the0807-geeknews-mcp-server","url":"https://pypi.org/project/iflow-mcp_the0807-geeknews-mcp-server/","firstSeenAt":"2026-09-09T21:24:21.644Z","fetchedAt":"2026-09-15T20:20:04.959Z","normalizedAt":"2026-09-15T20:20:04.959Z"}]},"firstSeenAt":"2026-09-09T21:24:21.644Z","updatedAt":"2026-09-15T20:21:28.668Z"}