Skip to main content
Glama
Sign In
Teams Guide MCP

Teams Guide MCP

by geunu97
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

teams-guide-mcp

클린 코드 가이드 문서를 제공하고 외부 프로젝트의 코드를 검사할 수 있는 MCP(Model Context Protocol) 서버입니다.

✨ 주요 기능

  • 📚 가이드 문서 제공: 클린 코드 작성 가이드 등 다양한 가이드 문서 읽기

  • 📖 외부 파일 읽기: 외부 프로젝트의 파일을 읽어서 분석 가능

  • 🔍 클린 코드 검사: 가이드를 기반으로 코드 품질 검사 및 개선 제안

Related MCP server: Smart Code Reviewer

🚀 빠른 시작

1. 설치

npm 패키지로 설치되어 있다면 바로 사용할 수 있습니다.

2. MCP 클라이언트 설정

Cursor/Claude Desktop 설정 예시:

{
  "mcpServers": {
    "guide-mcp": {
      "command": "npx",
      "args": ["-y", "teams-guide-mcp"]
    }
  }
}

설정 후 MCP 클라이언트를 재시작하세요.

🛠️ 사용 가능한 도구

get_guide

가이드 문서의 내용을 읽어서 반환합니다.

매개변수:

  • fileName (필수): 읽을 가이드 파일명 (예: clean-code-guide.md)

사용 예시:

"clean-code-guide.md 가이드를 읽어줘"

read_file

외부 프로젝트의 파일을 읽어서 반환합니다.

매개변수:

  • filePath (필수): 읽을 파일 경로 (상대 경로 또는 절대 경로)

사용 예시:

"read_file 도구로 ./src/utils.js 파일을 읽어줘"

check_clean_code

클린 코드 가이드를 기반으로 파일을 검사합니다.

매개변수:

  • filePath (필수): 검사할 파일 경로

  • guideName (선택): 사용할 가이드 파일명 (기본값: clean-code-guide.md)

사용 예시:

"check_clean_code로 ./src/index.js 파일을 클린 코드 가이드로 검사해줘"

📚 사용 가능한 리소스

MCP 클라이언트에서 guide://파일명 형태로 가이드 문서에 직접 접근할 수 있습니다.

예: guide://clean-code-guide.md

💡 사용 시나리오

시나리오 1: 클린 코드 가이드 읽기

"클린 코드 가이드의 네이밍 규칙을 알려줘"

시나리오 2: 외부 파일 읽기

"read_file로 ./src/utils.js를 읽어줘"

시나리오 3: 클린 코드 검사

"check_clean_code로 ./src/index.js를 검사하고 개선 사항을 제안해줘"

📁 프로젝트 구조

teams-guide-mcp/
├── src/
│   └── index.js          # MCP 서버 메인 코드
├── guides/
│   └── clean-code-guide.md   # 클린 코드 가이드 문서
└── package.json

🔧 개발자용

가이드 문서 추가

guides/ 디렉토리에 .md 또는 .txt 파일을 추가하면 자동으로 인식됩니다.

버전 관리 및 배포

이 프로젝트는 GitHub Actions를 사용하여 자동 배포를 지원합니다.

자동 배포 설정

태그가 v*.*.* 형식으로 푸시되면 자동으로:

  • package.json 버전 업데이트

  • npm에 패키지 배포

  • GitHub Release 생성

📋 요구사항

  • Node.js v20.18.0 이상

  • npm

📄 라이선스

MIT

Available Tools

3 tools
check_clean_codeC

클린 코드 가이드를 기반으로 파일을 검사합니다. 가이드 문서를 참조하여 코드 품질을 분석합니다.

Inputs: filePath (required), guideName.

get_guideC

가이드 문서의 내용을 읽어서 반환합니다.

Inputs: fileName (required).

read_fileC

외부 프로젝트의 파일을 읽어서 반환합니다. 절대 경로 또는 현재 작업 디렉토리 기준 상대 경로를 사용할 수 있습니다.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    C2.9/5.0

    Scored across 3 tools

    Disambiguation4/5

    The tools have distinct primary purposes: check_clean_code analyzes code quality, get_guide retrieves guide content, and read_file reads external project files. However, there is some potential overlap between get_guide and read_file, as both involve reading content, but their specific targets (guide vs. general files) help differentiate them.

    Naming Consistency4/5

    The tools follow a consistent verb_noun pattern (check_clean_code, get_guide, read_file), with all using snake_case. The naming is clear and predictable, though 'check' and 'read' are slightly different verb styles, but this minor deviation does not hinder usability.

    Tool Count3/5

    With only 3 tools, the server feels thin for a 'Teams Guide' purpose, as it might lack operations like updating guides or managing team-specific settings. However, the tools cover basic reading and analysis functions, making it borderline but not severely inadequate.

    Completeness2/5

    The tool surface is significantly incomplete for a 'Teams Guide' domain. It only supports reading and checking code against guides, with no tools for creating, updating, or deleting guides, managing teams, or handling user interactions, which are typical in such systems.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers