Contact Book MCP Server

인메모리 연락처 목록을 관리하는 간단한 Model Context Protocol (MCP) 서버입니다. mcp Python SDK의 FastMCP를 사용하여 구축했습니다.

기능

이 서버는 네 가지 도구를 제공합니다:

연락처는 메모리에 다음과 같이 저장됩니다:

contacts: dict[str, dict]  # name -> {"phone": ..., "email": ...}

참고: 데이터는 메모리에만 저장됩니다. 서버가 재구작되면 모든 연락처가 사라집니다.

Related MCP server: mcp-outlook-contacts

요구 사항

• Python 3.10+

• uv (서버 구동에 권장)

설치

1. 이 저장소를 크론하세요:

   git clone <your-repo-url>
   cd contact_book_server_mcp

2. 의존성을 설치하세요:

   pip install -r requirements.txt

   또는 uv를 사용하는 경우(권장 — 수동 설치 불요 — 어래 참조).

서버 실행

MCP Inspector 사용 (테스트/개발용)

uv run --with mcp mcp dev server.py

이 명령은 서버를 시작하고 브라우저에서 MCP Inspector를 열니다. 각 도구를 대화형으로 테스트할 수 있습니다.

독립 실행

python server.py

사용 예시

1. 연락처 추가

   add_contact(name="Humna Fahad", phone="03001234567", email="humna@test.com")
   → "Contact 'Humna Fahad' added successfully."

2. 연락처 조회

   get_contact(name="Humna Fahad")
   → {"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}

3. 연락처 검색

   search_contacts(query="Hum")
   → [{"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}]

4. 연락처 업데이트

   update_contact(name="Humna Fahad", phone="03009998888", email="humna@updated.com")
   → "Contact 'Humna Fahad' updated successfully."

프로젝트 상태

✅ 네 가지 도구 모두 구김되었이고 MCP Inspector를 통해 테스트되었습니다.

가능한 개선 사항

• delete_contact 도구 추가.

• list_all_contacts 도구 추가.

• 인메모리 저장 대신 JSON 파일이나 데이텁이개스저장에 연락처를 지속합니다.