ms365-mcp

작은 로컬 모델에 맞춰 설계된 Microsoft 365 MCP 서버입니다.

대부분의 MCP 서버는 큰 컨텍스트 윈도우를 가진 프론티어 모델을 위해 만들어져서, 벤더 API가 제공하는 모든 것을 노출하고 모델이 알아서 정리하도록 둡니다. 참조 Microsoft 365 서버는 Microsoft의 Graph OpenAPI 스펙에서 생성된 326개의 도구를 노출합니다.

그것은 8k 컨텍스트의 8B 모델에서는 작동하지 않습니다. 전체 도구 목록이 시스템 프롬프트에 들어가고, 모델은 스물다섯 개 도구를 지나면 어딘가에서 무작위로 선택하기 시작합니다. 이 서버는 반대 접근 방식을 취합니다:

• 손으로 작성한 열네 개 도구, 상한선은 스물 개로 고정. 도구 목록은 예산이지 기능 목록이 아닙니다.

• 작은 모델을 위해 작성된 설명, API 메타데이터에서 가져온 것이 아닙니다.

• 초안 우선. 정확히 하나의 도구만 다른 사람에게 전송할 수 있으며, 수신자 대신 초안 ID를 받고, 파괴적(destructive)으로 주석 처리됩니다.

• 모든 도구는 MCP readOnlyHint 및 destructiveHint 주석을 통해 자신의 효과를 선언하므로, 호스트가 도구 이름에서 추측하지 않고 분류할 수 있습니다.

Edge Harness를 위해 만들어졌으며, 모든 MCP 클라이언트에 유용합니다.

상태

초기 단계. 아직 사용할 수 없습니다. 계획은 열 개의 커밋입니다. 전체 순서와 각 결정의 근거는 docs/PLAN.md를 참조하세요.

Related MCP server: google-nice-mcp

도구 표면 확인하기

--list-tools는 아무것도 시작하지 않고 계정도 필요 없으므로, 아무것도 연결되기 전에 "호스트에게 무엇이 제공될까?"라는 질문에 답합니다:

.venv/bin/python -m ms365_mcp --list-tools

기계가 읽을 수 있는 버전을 보려면 --json을 추가하세요.

   read  whoami          Return the display name, email address and timezone…
   read  resolve_person  Look up a person by name or partial name and return…
   read  list_messages   List messages in a mail folder, newest first, as se…
  write  create_draft    Create a draft message. This does NOT send anything…
! write  send_draft      Send a draft that already exists, by its id. This r…
   ...
14 tools, 6 that change something, 4 marked destructive (!)

오늘날 핸들러는 스텁입니다: 호출하면 도구가 선언되었지만 구현되지 않았다는 문장을 반환합니다. 표면은 무엇이든 구축되기 전에 의도적으로 고정됩니다. 도구 이름, 설명, 효과 클래스는 호스트가 분류하고 모델이 프롬프트에 대해 학습하는 대상이므로, 나중에 변경하는 비용이 크기 때문입니다.

Edge Harness에서 사용하기

하네스는 이 서버를 stdio를 통한 하위 프로세스로 실행하므로, 자체 인터프리터로 실행되며 호스트와 의존성을 공유하지 않습니다. 이것은 우연이 아닙니다: 하네스에는 mcp/라는 로컬 패키지가 있고 PyPI의 공식 SDK도 mcp라고 불리므로, 이 서버를 하네스의 virtualenv에 설치하면 하네스 자체 패키지를 가리게 됩니다.

거기서의 레지스트리 항목은 ms365-own이며, Agent Lab 실행 옵션에서 Check를 누르면 모든 도구가 효과 클래스와 함께 나열됩니다. 열네 개 모두 declared로 분류되는데, 이는 하네스가 도구 이름에서 추측하는 대신 이 서버의 주석에서 가져왔다는 뜻이며, 항목에 재정의가 필요 없습니다.

하네스의 기본 초안 모드에서 send_draft는 보류되고 나머지 열세 개는 사용 가능하므로, 실행이 사람에게 도달할 수 없습니다.

보안

이 저장소는 공개되어 있으며 어떤 종류의 자격 증명도 보유하지 않습니다.

인증은 Microsoft 디바이스 코드 흐름을 사용합니다. 결과 토큰 캐시는 운영 체제의 구성 디렉터리에 소유자 전용 권한으로 기록되며, 이 저장소나 작업 트리에 절대 기록되지 않습니다. .gitignore는 어쨌든 토큰 및 캐시 파일 이름을 포함하며, pre-commit 훅은 자격 증명 형태의 문자열을 스테이징된 변경 사항에서 검사하므로, 실수로 커밋하는 것이 아니라 의도적인 노력이 있어야 커밋할 수 있습니다.

# pragma: allowlist secret으로 끝나는 줄은 훅에서 건너뜁니다. 이것은 이 저장소의 자체 테스트가 가짜 자격 증명을 포함할 수 있도록 존재하며, --no-verify와 달리 검토자가 diff에서 볼 수 있는 표시를 남깁니다. 확실히 가짜인 데이터에만 사용하세요.

개발

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q

클론당 한 번 비밀 스캔 훅을 활성화하세요:

git config core.hooksPath .githooks

라이선스

MIT. LICENSE를 참조하세요.