arthur-ficial/apfel-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Apfel (Apple's on-device LLM)이 웹에 도달하고 로컬 파일을 읽을 수있는 4 작은 MCP 도구 : url-fetch (페이지를 읽으십시오), ddg-search (웹 검색), 검색 및-fetch (search+read in one call), fs ...
개요
apfel-mcp는 그 능력을 정확히 추가하는 4 가지 작은 도구이며 다른 것은 없습니다. 각각의 결과가 이미 apfel의 작은 컨텍스트 창에 적합하기 위해 트리밍을 반환합니다 (실제 후에 truncated). 그들은 MCP 서버: 당신은 --mcp를 가진 apfel에 1개를 붙이고, 모형은 그것을 필요로 할 때 호출합니다. 견적 요청 사용 - 그것은 대부분의 "웹에서 뭔가를보고 대답"하나의 필요, 토큰 - cheap 도구 호출. - - 웹 페이지를 fetch, Readability를 통해 주요 기사 바디를 추출, 깨끗한 마크 다운 반환. 기본 ~4000 숯, 단단한 모자 6000 숯 (~1500 토큰). SSRF 가드: http/https만, 개인 네트워크 차단, 10-second timeout, 2 MB 다운로드 캡. - — DuckDuckGo 웹 검색, API 키 필요 없음. ~300개의 토큰에서 상위 5개의 결과를 반환합니다. — DuckDuckGo는 공개 검색 API를 제공하지 않습니다. 그래서 HTML 엔드포인트를 사용합니다. 예상 가끔 휴식. ddg-search 동굴을 참조하십시오. - - 화합물 도구 : 단일 도구 호출에서 상단 N 결과를 검색하십시오.
개요(AI 번역)
**apfel은 Apple의 on-device 모델을 실행합니다. 인터넷에 도달하거나 자체에 파일을 읽을 수 없습니다. ** apfel-mcp는 그 능력을 정확히 추가하는 4 가지 작은 도구이며 다른 것은 없습니다. 각 결과가 이미 apfel의 작은 4096-token context window에 적합하기 위해 트리밍을 반환합니다.
그들은 MCP 서버: 당신은 --mcp]와 함께 apfel에 하나를 첨부하고, 모델은 필요할 때 호출합니다.
# 어떤 도구가 필요합니까?
| 이용안내 | | 주의 |
|—|—||||||
| ページを選択 | apfel-mcp-url-fetch | 의 URL | 문서 텍스트, 광고 벗겨 |
| 웹 검색 | apfel-mcp-ddg-search | 검색 쿼리 | 실험 (DuckDuckGo 스크랩) |
| 웹을 필요로 하는 질문 | apfel-mcp-search-and-fetch | 질문 | 검색** and** reads, in one call - start here |
| 현지 텍스트 파일 읽기 | [T4] | 파일 경로 | 읽기 전용, 쓰기/ 삭제 |
견적 요청 use apfel-mcp-search-and-fetch - 웹에서 가장 “look something up on the web and Answer” needs in a single, Token-cheap tool call.
4개의 MCPs, 세부사항에서
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
apfel-mcp
apfel runs Apple’s on-device model - it cannot reach the internet or read your files on its own. apfel-mcp is four small tools that add exactly those abilities, and nothing else. Each returns a result already trimmed to fit apfel’s tiny 4096-token context window (not truncated after the fact).
They are MCP servers: you attach one to apfel with --mcp, and the model calls it when it needs to.
Which tool do I need?
| You want to… | Use | You give it | Note |
|---|---|---|---|
| Read a specific web page | apfel-mcp-url-fetch |
a URL | article text, ads stripped |
| Search the web | apfel-mcp-ddg-search |
a search query | experimental (DuckDuckGo scrape) |
| Ask a question that needs the web | apfel-mcp-search-and-fetch |
a question | searches and reads, in one call - start here |
| Read a local text file | apfel-mcp-fs |
a file path | read-only, no writing/deleting |
Not sure? Use apfel-mcp-search-and-fetch - it covers most “look something up on the web and answer” needs in a single, token-cheap tool call.
The four MCPs, in detail
apfel-mcp-url-fetch— fetch a web page, extract the main article body via Readability, return clean markdown. Default ~4000 chars, hard cap 6000 chars (~1500 tokens). SSRF guards:http/httpsonly, private-network blocklist, 10-second timeout, 2 MB download cap.apfel-mcp-ddg-search— DuckDuckGo web search, no API key required. Returns top 5 results in ~300 tokens. Experimental, unofficial, scraping-based — DuckDuckGo does not provide a public search API, so this uses their HTML endpoint. Expect occasional breakage. See ddg-search caveats.apfel-mcp-search-and-fetch— compound tool: search then fetch the top N results in a single tool call. Saves ~500 tokens of tool-call schema and conversation overhead versus calling search + fetch separately. Hard cap 5000 chars (~1250 tokens).apfel-mcp-fs— read a bounded slice of a local text file. Read-only: it cannot write, move, or delete anything. Path allowlist viaAPFEL_MCP_FS_ROOTS(defaults to the working directory); paths outside the roots and binary files are refused. Default ~4000 chars, hard cap 6000 chars. See fs caveats.
Why a separate repo
설치
npx @modelcontextprotocol/inspector python -m apfel_mcp.url_fetch_server