안녕하세요 여러분,
저는 MCP Basic Servers라고 불리는 소규모 오픈 소스 MCP 서버 번들을 공개했습니다:
https://github.com/mchowy-troll/mcp-basic-servers
이것은 리눅스(Linux)에서 로컬 MCP HTTP 서버를 실행하기 위한 간단한 Bash 설치 스크립트 모음입니다.
아이디어는 간단합니다: 스크립트 하나를 실행하고, 몇 가지 질문에 답하면, /mcp 경로에서 작동하는 로컬 MCP 엔드포인트(endpoint)를 얻게 됩니다.
이 프로젝트는 Python 환경, systemd 서비스, SQLite 데이터베이스 또는 로컬 웹 검색을 처음부터 수동으로 설정하지 않고 집에서 MCP 도구를 실험해보고 싶은 초급 및 중급 리눅스(Linux) 사용자를 위해 만들어졌습니다.
이것은 기업용(enterprise-grade) 또는 강화된 프로덕션 플랫폼을 지향하지 않습니다. 의도적으로 단순하고 읽기 쉬우며, 로컬/홈 사용 용도로 설계되었습니다.
첫 번째 릴리스에는 6개의 서버가 포함되어 있습니다:
- web — 로컬 SearXNG를 통한 실시간 웹 검색 및 웹페이지 가져오기
- files — 텍스트, CSV, Markdown 및 PDF를 위한 로컬 워크스페이스 도구
- memory — 로컬 SQLite 기반 메모리
- contacts — 로컬 SQLite 기반 연락처
- wiki_verifier — Wikidata 및 Wikipedia 컨텍스트/검증 도구
- weather — Open-Meteo를 사용하는 날씨 도구
기본 포트는 8001-8006이며, 각 서버는 다음과 같은 MCP 엔드포인트(endpoint)를 노출합니다:
[http://127.0.0.1:8001/mcp](http://127.0.0.1:8001/mcp)
또는 로컬 네트워크의 다른 장치에서:
http://YOUR_LOCAL_IP:8001/mcp
저는 최종 패키지를 Arch Linux와 **Ubuntu 기반 리눅스(Linux)**에서 테스트했습니다.
몇 가지 설계 선택 사항:
- systemd 서비스
.env 런타임 설정
- 자동 시간대(timezone) 감지
- 선택 가능한 도구 설명 언어:
pl, en, de, fr, it, es
- Caddy/리버스 프록시(reverse proxy)는 문서로만 제공되며 자동으로 설치되지 않음
- 로컬 또는 신뢰할 수 있는 LAN 사용을 의도함
MCP를 배우고 있거나, 로컬 AI 도구를 실행하거나, 소규모 홈랩(home-lab) 설정을 구축하면서 직접 검사하고 수정할 수 있는 간단한 무언가를 원하신다면 이 프로젝트가 유용할 수 있습니다.
특히 로컬 MCP 설정을 실험하고 계신 분들의 피드백을 환영합니다.
저장소 (Repository):
https://github.com/mchowy-troll/mcp-basic-servers