- MCP Context Template
MCP Context Template
MCP Context Template
Introduction
MCP Context Template is a repository designed to centrally manage AI tools (MCP) to reduce context sharing costs and improve development productivity.
It serves as a central context repository that helps modern AI tools like Claude Code and Cursor AI consistently understand your company's codebase and development practices.
Purpose
- Common context repository managed independently from individual projects
- Providing reference document structure to improve collaboration efficiency with AI tools
- Containing examples and guides that can be used by different teams and organizational layers
- Providing consistent AI usage experience across projects
- Reducing the burden of duplicate context management
Directory Structure
ai-context/
โโโ README.md
โโโ context/
โ โโโ backend/
โ โ โโโ domain-overview.md
โ โ โโโ service-patterns.md
โ โ โโโ test-guidelines.md
โ โโโ frontend/
โ โ โโโ component-structure.md
โ โ โโโ naming-convention.md
โ โโโ mobile/
โ โ โโโ network-layer.md
โ โโโ shared/
โ โโโ business-terms.md
โ โโโ naming-style.md
โโโ prompts/
โ โโโ refactoring.md
โ โโโ test-generation.md
โ โโโ code-review.md
โโโ examples/
โโโ cursor-snippets.md
โโโ claude-usage.md
How to Use
1. Project Integration
- Set
ai-context/as a context path in your project's.clodercor Cursor settings - Explicitly reference guides in Claude Code prompts with "Please refer to the following guide: [path]"
- Example: Request refactoring based on
context/backend/service-patterns.md
Refactoring request:
Please refactor the following code according to the service patterns defined in context/backend/service-patterns.md.
[INSERT CODE]
2. Contribution Guidelines
- Contribute via Pull Request
- Write all convention documents in Markdown
- Propose significant context structure changes as issues first for discussion
- Write context concisely and clearly for easy AI understanding
3. Prompt Writing Examples
Example from prompts/test-generation.md:
## Purpose
Claude prompt example for automating service unit test generation
## Prompt
Please write unit test code for the following service class method:
- Test framework: JUnit5
- Mocking: MockK
- Use Given-When-Then format
- Target method:
```kotlin
fun getUserById(id: Long): User
Use Cases
- New developer onboarding - quickly understand code styles and patterns
- Automation of repetitive coding tasks - generating test code, boilerplate
- Code review automation - generate review comments with consistent standards
- Documentation support - assist in codebase documentation tasks
MCP Context Template(Korean)
์๊ฐ
MCP Context Template์ AI ๋๊ตฌ(MCP)๋ฅผ "์ค์ ์ง์ค์"์ผ๋ก ๊ด๋ฆฌํ์ฌ ์ปจํ ์คํธ ๊ณต์ ๋น์ฉ์ ์ค์ด๊ณ ๊ฐ๋ฐ ์์ฐ์ฑ์ ๋์ด๊ธฐ ์ํ ๋ ํฌ์งํ ๋ฆฌ์ ๋๋ค.
Claude Code, Cursor AI ๋ฑ ์ต์ AI ๋๊ตฌ๋ค์ด ์ผ๊ด๋ ๋ฐฉ์์ผ๋ก ํ์ฌ์ ์ฝ๋๋ฒ ์ด์ค์ ๊ฐ๋ฐ ๊ดํ์ ์ดํดํ ์ ์๋๋ก ๋๋ ์ค์ ์ปจํ ์คํธ ์ ์ฅ์๋ก ๊ธฐ๋ฅํฉ๋๋ค.
๋ชฉ์
- ํ๋ก์ ํธ์ ๋ ๋ฆฝ์ ์ผ๋ก ๊ด๋ฆฌ๋๋ ๊ณตํต ์ปจํ ์คํธ ์ ์ฅ์
- AI ๋๊ตฌ์์ ํ์ ํจ์จ์ ๋์ด๊ธฐ ์ํ ์ฐธ๊ณ ๋ฌธ์ ๊ตฌ์กฐ ์ ๊ณต
- ํ๋ณ, ๊ณ์ธต๋ณ๋ก ํ์ฉ ๊ฐ๋ฅํ ์์์ ๊ฐ์ด๋ ์๋ก
- ํ๋ก์ ํธ ๊ฐ ์ผ๊ด๋ AI ์ฌ์ฉ ๊ฒฝํ ์ ๊ณต
- ์ค๋ณต ์ปจํ ์คํธ ๊ด๋ฆฌ ๋ถ๋ด ๊ฐ์
๋๋ ํ ๋ฆฌ ๊ตฌ์กฐ
ai-context/
โโโ README.md
โโโ context/
โ โโโ backend/
โ โ โโโ domain-overview.md
โ โ โโโ service-patterns.md
โ โ โโโ test-guidelines.md
โ โโโ frontend/
โ โ โโโ component-structure.md
โ โ โโโ naming-convention.md
โ โโโ mobile/
โ โ โโโ network-layer.md
โ โโโ shared/
โ โโโ business-terms.md
โ โโโ naming-style.md
โโโ prompts/
โ โโโ refactoring.md
โ โโโ test-generation.md
โ โโโ code-review.md
โโโ examples/
โโโ cursor-snippets.md
โโโ claude-usage.md
ํ์ฉ ๋ฐฉ๋ฒ
1. ํ๋ก์ ํธ์์์ ํ์ฉ
- ํ๋ก์ ํธ ๋ด
.cloderc๋๋ Cursor ์ค์ ์์ai-context/๋ฅผ context path๋ก ์ง์ - Claude Code ํ๋กฌํํธ ์์ฑ ์ "๋ค์ ๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํด์ฃผ์ธ์: [๊ฒฝ๋ก]"์ ๊ฐ์ด ๋ช ์์ ์ผ๋ก ์ธ๊ธ
- ์์:
context/backend/service-patterns.md์ ๊ธฐ๋ฐํ ๋ฆฌํฉํ ๋ง ์์ฒญ
๋ฆฌํฉํ ๋ง ์์ฒญ:
context/backend/service-patterns.md์ ์ ์๋ ์๋น์ค ํจํด์ ๋ฐ๋ผ ๋ค์ ์ฝ๋๋ฅผ ๋ฆฌํฉํ ๋งํด ์ฃผ์ธ์.
[์ฝ๋ ์ฝ์
]
2. ๋ฌธ์ ๊ธฐ์ฌ ๊ฐ์ด๋
- Pull Request๋ฅผ ํตํด ๊ธฐ์ฌ
- ๋ชจ๋ ์ปจ๋ฒค์ ๋ฌธ์๋ Markdown์ผ๋ก ์์ฑ
- ํฐ ์ปจํ ์คํธ ๊ตฌ์กฐ ๋ณ๊ฒฝ์ ์ด์๋ก ๋จผ์ ์ ์ ํ ๋ ผ์
- ์ปจํ ์คํธ๋ ๊ฐ๊ฒฐํ๊ณ ๋ช ํํ๊ฒ ์์ฑํ์ฌ AI๊ฐ ์ดํดํ๊ธฐ ์ฝ๊ฒ ๊ตฌ์ฑ
3. ํ๋กฌํํธ ์์ฑ ์์
prompts/test-generation.md ์์:
## ๋ชฉ์
์๋น์ค ๋จ์ ํ
์คํธ ์๋ํ๋ฅผ ์ํ Claude์ฉ ํ๋กฌํํธ ์์
## ํ๋กฌํํธ
์๋น์ค ํด๋์ค์ ๋ฉ์๋์ ๋ํด ๋จ์ ํ
์คํธ ์ฝ๋๋ฅผ ์์ฑํด์ฃผ์ธ์.
- ํ
์คํธ ํ๋ ์์ํฌ: JUnit5
- ๋ชจํน: MockK
- Given-When-Then ํ์ ์ฌ์ฉ
- ํ
์คํธ ๋์ ๋ฉ์๋:
```kotlin
fun getUserById(id: Long): User
ํ์ฉ ์ฌ๋ก
- ์๋ก์ด ๊ฐ๋ฐ์ ์จ๋ณด๋ฉ - ์ฝ๋ ์คํ์ผ๊ณผ ํจํด์ ๋น ๋ฅด๊ฒ ์ดํด
- ๋ฐ๋ณต์ ์ธ ์ฝ๋ ์์ ์๋ํ - ํ ์คํธ ์ฝ๋, ๋ณด์ผ๋ฌํ๋ ์ดํธ ์์ฑ
- ์ฝ๋ ๋ฆฌ๋ทฐ ์๋ํ - ์ผ๊ด๋ ๊ธฐ์ค์ผ๋ก ๋ฆฌ๋ทฐ ์ฝ๋ฉํธ ์์ฑ
- ๋ฌธ์ํ ์ง์ - ์ฝ๋๋ฒ ์ด์ค ๋ฌธ์ํ ์์ ๋ณด์กฐ