mcp-for-beginners / te

# AGENTS.md

## ప్రాజెక్టు అవగాహన

**కొత్తవారికి MCP** అనేది Model Context Protocol (MCP) నేర్చుకోవడానికి ఓపెన్-సోర్స్ విద్యా పరీక్షాంశం - ఇది AI మోడల్స్ మరియు క్లయింట్ అప్లికేషన్స్ మధ్య పరస్పర చర్యలకు ఒక ప్రమాణీకృత నేపథ్యం. ఈ రిపాజిటరీలో వివిధ ప్రోగ్రామింగ్ భాషలలో హ్యాండ్స్-ఆన్ కోడ్ ఉదాహరణలతో సమగ్ర అధ్యయన పదార్థాలు అందుబాటులో ఉన్నాయి.

### ప్రధాన సాంకేతికతలు

- **ప్రోగ్రామింగ్ భాషలు**: C#, జావా, జావాస్క్రిప్ట్, టైప్స్ క్రిప్ట్, పైథాన్, రస్ట్
- **ఫ్రేమ్‌వర్క్‌లు & SDKలు**: 
  - MCP SDK (`@modelcontextprotocol/sdk`)
  - స్ప్రింగ్ బూట్ (జావా)
  - ఫాస్ట్ MCP (పైథాన్)
  - లాంగ్ చైన్4జె (జావా)
- **డేటాబేస్‌లు**: pgvector ఎక్స్‌టెన్షన్‌తో పోస్ట్గ్రెSQL
- **క్లౌడ్ ప్లాట్‌ఫారమ్‌లు**: ఆజ్యూర్ (కంటైనర్ యాప్‌లు, ఓపెన్‌ఎఏఐ, కంటెంట్ సేఫ్టీ, అప్లికేషన్ ఇన్సైట్స్)
- **బిల్డ్ టూల్స్**: npm, మేవెన్, పిప్, కార్గో
- **డాక్యుమెంటేషన్**: స్వయం-చలిత బహుభాషా అనువాదంతో మార్క్‌డౌన్ (48+ భాషలు)

### నిర్మాణం

- **11 కోర్ మోడ్యూల్స్ (00-11)**: ప్రాథమికం నుండి అధునాతన విషయాల వరుస క్రమం విద్య
- **హ్యాండ్స్-ఆన్ ల్యాబ్స్**: బహుభాషా పూర్తి పరిష్కార కోడ్‌తో ప్రాక్టికల్ వ్యాయామాలు
- **నమూనా ప్రాజెక్టులు**: పనిచేసే MCP సర్వర్ మరియు క్లయింట్ అమలు
- **అనువాద వ్యవస్థ**: బహుభాషా మద్దతు కోసం ఆటోమేటెడ్ గిట్‌హబ్ చర్యలు వర్క్‌ఫ్లో
- **జాడ చిత్రాలు**: అనువాద రూపాలతో కేంద్రీకృత చిత్రాల డైరెక్టరీ

## సెటప్ ఆజ్ఞలు

ఇది డాక్యుమెంటేషన్-ఆధారిత రిపాజిటరీ. ఎక్కువ సెటప్ ప్రత్యేక నమూనా ప్రాజెక్టులు మరియు ల్యాబ్స్‌లో జరుగుతుంది.

### రిపాజిటరీ సెటప్

```bash
# రిపాజిటరీని క్లోన్ చేయండి
git clone https://github.com/microsoft/mcp-for-beginners.git
cd mcp-for-beginners
```

### నమూనా ప్రాజెక్టులతో పని

నమూనా ప్రాజెక్టులు ఈ చోట్ల ఉంటాయి:
- `03-GettingStarted/samples/` - భాషకు ప్రత్యేక ఉదాహరణలు
- `03-GettingStarted/01-first-server/solution/` - మొదటి సర్వర్ అమలు
- `03-GettingStarted/02-client/solution/` - క్లయింట్ అమలు
- `11-MCPServerHandsOnLabs/` - సమగ్ర డేటాబేస్ ఏకీకరణ ల్యాబ్స్

ప్రతి నమూనా ప్రాజెక్టుకు ప్రత్యేక సెటప్ సూచనలు ఉంటాయి:

#### టైప్స్క్రిప్ట్/జావాస్క్రిప్ట్ ప్రాజెక్టులు
```bash
cd <project-directory>
npm install
npm start
```

#### పైథాన్ ప్రాజెక్టులు
```bash
cd <project-directory>
pip install -r requirements.txt
# లేదా
pip install -e .
python main.py
```

#### జావా ప్రాజెక్టులు
```bash
cd <project-directory>
mvn clean install
mvn spring-boot:run
```

## అభివృద్ధి వర్క్‌ఫ్లో

### MCP 7-28 సిద్దత

#### రిపో సిద్ధత తనిఖీ జాబితా

- [x] **కొత్త సహకారుల స్పష్టత**: ఈ ఫైల్ రిపాజిటరీ ఉద్దేశం,
  నిర్మాణం, సహకార నిబంధనలు మరియు నమూనా సెటప్ మార్గాలను నిర్వచిస్తుంది.
- [x] **ఖచ్చితమైన ఫ్లాగ్‌లతో బిల్డ్/టెస్ట్/లింట్ కమాండ్లు**:
  - రిపాజిటరీ డాక్స్ లింట్:
    `npx --yes markdownlint-cli2 "**/*.md" "#node_modules" "#translations" "#translated_images"`
  - రిపాజిటరీ డాక్స్ లింక్ నమూనా ఆడిట్:
    `find . -name "*.md" -not -path "*/node_modules/*" -not -path "./translations/*" -not -path "./translated_images/*" -print0 | xargs -0 grep -En "\[.*\]\(.*\)"`
  - టైప్స్క్రిప్ట్ నమూనా ధృవీకరణ:
    `cd 03-GettingStarted/samples/typescript && npm ci && npm test && npm run build`
  - పైథాన్ నమూనా ధృవీకరణ:
    `cd 10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/code/weather_mcp && python -m pip install -e . && pytest -q`
  - జావా నమూనా ధృవీకరణ:
    `cd 03-GettingStarted/samples/java/calculator && mvn -B -ntp test verify`
- [x] **ఒక సాధ్యమైన వాస్తవ వర్క్‌ఫ్లో MCP టూల్ కావచ్చు**:
  `validate_curriculum_change`
- [x] **ఇన్‌పుట్‌లు/ఔట్‌పుట్‌లు స్పష్టం** (ఇదివరకు స్పెసిఫికేషన్ చూడండి).
- [x] **అనుమతులు మరియు వైఫల్య పరిస్థితులు డాక్యుమెంట్ చేయబడ్డాయి** (అరకు స్పెసిఫికేషన్ చూడండి).
- [x] **CI టెస్ట్ చేయుట స్పష్టంగా ఉంది** (నిర్దేశిత ఆదేశాలు, స్పష్టమైన
  ఎగ్జిట్ కోడ్‌లు, యంత్రం చదువుకోగల అవుట్పుట్లు).

#### అభ్యర్ధిత MCP టూల్ వర్క్‌ఫ్లో: `validate_curriculum_change`

##### లక్ష్యం

సిలబస్ డాక్యుమెంటేషన్ మార్పులు మరియు ప్రతినిధి నమూనా కోడ్
ఆరోగ్యాన్ని విలీనం ముందు నిర్ధారించండి.

##### ఇన్‌పుట్‌లు

- `changed_paths: string[]` (అవసరం) - PRలో మార్చబడిన సంబంధిత మార్గాలు.
- `run_docs_lint: boolean` (డిఫాల్ట్ `true`)
- `run_links_audit: boolean` (డిఫాల్ట్ `true`)
- `run_samples: { typescript?: boolean, python?: boolean, java?: boolean }`
  (డిఫాల్ట్ అంతా `false`)

##### అవుట్పుట్‌లు

- `status: "ok" | "failed"`
- `checks: Array<{ name: string, command: string, exit_code: number,
  summary: string }>`
- `artifacts: Array<{ type: "log" | "report", path: string }>`
- `failed_checks: string[]`

##### అనుమతులు

- వర్క్‌స్పేస్ ఫైళ్లను చదవండి మరియు సాధన-సృష్టించిన ఆర్టిఫాక్ట్‌లను మాత్రమే వ్రాయండి (ఉదా: లింట్
  నివేదికలు, పరీక్షా లాగ్‌లు); `translations/` లేదా
  `translated_images/`లో వ్రాయవద్దు.
- స్థానిక షెల్ ఆదేశాలను అమలు చేయండి.
- ప్యాకేజీ రీస్టోర్ (`npm ci`,
  `python -m pip install`, `mvn` ఆధారపడి నెట్‌వర్క్ యాక్సెస్ మాత్రమే ఐచ్ఛికం).
- `translations/` లేదా
  `translated_images/`లో పుష్, మерж్ లేదా మార్పులు చేయడం అనుమతించదు.

##### విఫలమయ్యే పరిస్థితులు

- `E_NO_INPUT_PATHS`: `changed_paths` ఖాళీగా ఉంది.
- `E_INVALID_PATH`: ఇన్‌పుట్ మార్గం రిపాజిటరీ రూట్ నుండి తప్పిపోయింది.
- `E_LINT_FAILED`: మార్క్‌డౌన్ లింట్ తప్పుగా ముగిసింది.
- `E_LINK_AUDIT_FAILED`: లింక్ ఆడిట్ ఆదేశం తప్పుగా ముగిసింది.
- `E_SAMPLE_TEST_FAILED`: నమూనా పరీక్ష/బిల్డ్ తప్పుగా ముగిసింది.
- `E_TIMEOUT`: ఆదేశం నిర్దేశిత సమయ పరిమితిని దాటి ఉంది.

##### సిఫార్సు చేసిన CI ఒప్పందం

నిర్ధారణ ఆటోమేషన్ కోసం CI పని ఏర్పాటుచేయండి:

- `*.md`, నమూనా కోడ్, లేదా ఈ ఫైల్‌ను టచ్ చేసే పుల్ రిక్వెస్ట్‌లపై ట్రిగ్గర్ అవుతుంది.
- మించి పేర్కొన్న ఖచ్చితమైన ఆదేశాలను నడుపుతుంది.
- లాగ్‌లను ఆర్టిఫాక్ట్‌లుగా నిల్వచేస్తుంది.
- ఏదైనా నాన్-జీరో ఎగ్జిట్ కోడ్‌పై పని విఫలమవుతుంది.

#### మీరు ఈ రిపో నుండి MCP సర్వర్‌ను పంపినట్లయితే

- [ ] MCP 7-28 కోసం డ్రాఫ్ట్ చేంజ్‌లాగ్‌ను చదవండి:
  <https://modelcontextprotocol.io/specification/draft/changelog>
- [ ] మీ సర్వర్ SDK బీటాపై పరీక్షించండి:
  <https://blog.modelcontextprotocol.io/posts/sdk-betas-2026-07-28/>
- [ ] సెషన్ మరియు హ్యాండ్‌షేక్ ఊహాగానాలను తీసివేయండి; ప్రతి అభ్యర్థనను
  స్వీయ-కంటైన్డ్ గా పరిగణించండి:
  <https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/#a-stateless-protocol>
- [ ] రా HTTP అభ్యర్థనలకు `Mcp-Method` మరియు `Mcp-Name` హెడర్లను పంపండి:
  <https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/#routable-cacheable-traceable>
- [ ] హార్డ్‌కోడ్ చేసిన లోప కోడ్‌లను ఆడిట్ చేయండి (`missing resource` `-32002` నుండి `-32602` కు మార్చబడింది).
- [ ] హెచ్చరిక మరియు పునఃస్థాపన కోసం డిప్రికేటెడ్ రూట్లు, నమూనాలు, మరియు
  లాగింగ్:
  <https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/#roots-sampling-and-logging-are-deprecated>
- [ ] ప్రయోగాత్మక `2025-11-25` టాస్క్స్ API నుండి మైగ్రేట్ అవ్వండి:
  <https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/#tasks-graduates-to-an-extension>
- [ ] OAuth మరియు OpenID కనెక్ట్ కఠినతకు అనుమతులను సమీక్షించండి:
  <https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/#authorization-hardening>

### డాక్యుమెంటేషన్ నిర్మాణం

- **మోడ్యూల్స్ 00-11**: వరుస క్రమంలో ప్రధాన పాఠ్యప్రణాళిక విషయాలు
- **translations/**: భాష-ప్రత్యేక వెర్షన్స్ (యథావిధిగా స్వయం-సృష్టి, నేరుగా మార్చవద్దు)
- **translated_images/**: స్థానికీకృత చిత్రాల వెర్షన్స్ (ఆటోమేటెడ్)
- **images/**: మూల చిత్రాలు మరియు చార్ట్‌లను

### డాక్యుమెంటేషన్ మార్పులు చేయడం

1. మూల మోడ్యూల్ డైరెక్టరీలలో (00-11) మాత్రమే ఇంగ్లీష్ మార్క్డౌన్ ఫైళ్ళను సవరిం చేయండి
2. అవసరమైతే `images/` డైరెక్టరీలో చిత్రాలను నవీకరించండి
3. కో-ఆప్-ట్రాన్స్‌లేటర్ GitHub చర్య స్వయంచాలకంగా అనువాదాలని సృష్టిస్తుంది
4. మేన్ శాఖకు పుష్ చేసినప్పుడు అనువాదాలు పునఃసృష్టించబడతాయి

### అనువాదాలతో పని చేయడం

- **ఆటోమేటెడ్ అనువాదం**: GitHub చర్యలు అన్ని అనువాదాలను నిర్వహిస్తాయి
- `translations/` డైరెక్టరీలో ఫైళ్ళను మాన్యువల్‌గా మార్చకండి
- అనువాద మెటాడేటా ప్రతి అనువదించిన ఫైల్‌లో కలుపబడింది
- మద్దతు పొందిన భాషలు: అరబిక్, చైనీస్, ఫ్రెంచ్, జర్మన్, హిందీ, జపనీస్, కొరియన్, పోర్చుగీస్, రష్యన్, స్పానిష్ సహా 48+ భాషలు

## పరీక్ష సూచనలు

### డాక్యుమెంటేషన్ ధృవీకరణ

ఇది ప్రధానంగా డాక్యుమెంటేషన్ రిపాజిటరీ కావడంతో, పరీక్ష ఈ క్రిందల పై కేంద్రీకృతమవుతుంది:

1. **లింక్ నమూనా ఆడిట్**: సమీక్ష కోసం మార్క్‌డౌన్ లింక్ల జాబితా

   ```bash
   # సూచిక మార్క్డౌన్ లింకులు (ప్యాటర్న్ ఆడిట్)
   find . -name "*.md" -not -path "*/node_modules/*" -not -path "./translations/*" -not -path "./translated_images/*" -print0 | xargs -0 grep -En "\[.*\]\(.*\)"
   ```

2. **కోడ్ నమూనా ధృవీకరణ**: కోడ్ ఉదాహరణలు కంపైల్/నడిచే టెస్ట్ చేయండి

   ```bash
   # నిర్దిష్ట నమూనా వద్దికి వెళ్లి దాని పరీక్షలను నిర్వహించండి
   cd 03-GettingStarted/samples/typescript
   npm install && npm test
   ```

3. **మార్క్‌డౌన్ లింటింగ్**: ఫార్మాటింగ్ సారూప్యత తనిఖీ

   ```bash
   # అవసరమైతే markdownlint ఉపయోగించండి
   npx --yes markdownlint-cli2 "**/*.md" "#node_modules" "#translations" "#translated_images"
   ```

### నమూనా ప్రాజెక్ట్ పరీక్ష

ప్రతి భాష-ప్రత్యేక నమూనా లో పరీక్షా విధానం వేరు ఉంటుంది:

#### టైప్స్క్రిప్ట్/జావాస్క్రిప్ట్
```bash
npm test
npm run build
```

#### పైథాన్
```bash
pytest
python -m pytest tests/
```

#### జావా
```bash
mvn test
mvn verify
```

## కోడ్ శైలి మార్గదర్శకాలు

### డాక్యుమెంటేషన్ శైలి

- స్పష్టమైన, ప్రారంభికులకు అనుకూలమైన భాష ఉపయోగించండి
- అవసరమైన చోట పలు భాషల కోడ్ ఉదాహరణలు చేర్చండి
- మార్క్‌డౌన్ ఉత్తమ ఆచారాలు అనుసరించండి:
  - ATX-స్టైల్ హెడ్డర్‌లను ఉపయోగించండి (`#` సింటాక్స్)
  - భాష నియామకాలతో ఫెన్స్ చేసిన కోడ్ బ్లాక్స్ ఉపయోగించండి
  - చిత్రాలకు వివరణాత్మక అల్ట్ టెక్స్‌ను చేర్చండి
  - లైన్ పొడవులను సారమైనంగా ఉంచండి (కఠిన పరిమితి లేదు కానీ జాగ్రత్తగా)

### కోడ్ నమూనా శైలి

#### టైప్స్క్రిప్ట్/జావాస్క్రిప్ట్
- ES మాడ్యూల్స్ (`import`/`export`) ఉపయోగించండి
- టైప్స్క్రిప్ట్ కఠిన మోడ్ సూత్రాలు అనుసరించండి
- ప్రকারపు వ్యాఖ్యానాలను చేర్చండి
- ES2022 లక్ష్యంగా ఉంచండి

#### పైథాన్
- PEP 8 శైలి మార్గదర్శకాలను అనుసరించండి
- అవసరమైతే టైప్ సూచనలు ఉపయోగించండి
- ఫంక్షన్లు మరియు తరగతులకు డాక்ஸ్ట్రింగ్‌లు చేర్చండి
- ఆధునిక పైథాన్ ఫీచర్లను ఉపయోగించండి (3.8+)

#### జావా
- స్ప్రింగ్ బూట్ సూత్రాలను అనుసరించండి
- జావా 21 ఫీచర్లను ఉపయోగించండి
- ప్రమాణ మేవెన్ ప్రాజెక్ట్ నిర్మాణం అనుసరించండి
- జావా డాక్యుమెంట్ వ్యాఖ్యలను చేర్చండి

### ఫైల్ స్వరూపం

```
<module-number>-<ModuleName>/
├── README.md              # Main module content
├── samples/               # Code examples (if applicable)
│   ├── typescript/
│   ├── python/
│   ├── java/
│   └── ...
└── solution/              # Complete working solutions
    └── <language>/
```

## బిల్డ్ మరియు డిప్లాయ్‌మెంట్

### డాక్యుమెంటేషన్ డిప్లాయ్‌మెంట్

రిపాజిటరీ GitHub పేజెస్ లేదా సమాన సేవలను డాక్యుమెంటేషన్ హోస్టింగ్ కోసం ఉపయోగిస్తుంటుంది (అన్వయిస్తే). మెయిన్ బ్రాంచ్‌కు మార్పులు ట్రిగ్గర్ చేస్తాయి:

1. అనువాద వర్క్‌ఫ్లో (`.github/workflows/co-op-translator.yml`)
2. అన్ని ఇంగ్లీష్ మార్క్డౌన్ ఫైళ్ల ఆటోమేటెడ్ అనువాదం
3. అవసరాలను అనుసరించి చిత్రం స్థానికీకరణ

### బిల్డ్ ప్రక్రియ అవసరం లేదు

ఈ రిపాజిటరీ ప్రధానంగా మార్క్‌డౌన్ డాక్యుమెంటేషన్ కలిగి ఉంది. కోర్ సిలబస్ కంటెంట్ కోసం సమీకరణ లేదా బిల్డ్ దశ అవసరం లేదు.

### నమూనా ప్రాజెక్ట్ డిప్లాయ్‌మెంట్

వ్యక్తిగత నమూనా ప్రాజెక్టులకు డిప్లాయ్‌మెంట్ సూచనలు ఉండవచ్చు:
- MCP సర్వర్ డిప్లాయ్‌మెంట్ గైడెన్స్ కోసం `03-GettingStarted/09-deployment/` చూడండి
- `11-MCPServerHandsOnLabs/`లో ఆజ్యూర్ కంటైనర్ యాప్‌లు డిప్లాయ్‌మెంట్ ఉదాహరణలు

## సహకార నిబంధనలు

### పుల్ రిక్వెస్ట్ ప్రక్రియ

1. **ఫోర్క్ మరియు క్లోన్**: రిపాజిటరీని ఫోర్క్ చేసి మీ ఫోర్క్‌ను లోకల్‌లో క్లోన్ చేయండి
2. **ఒక బ్రాంచ్ సృష్టించండి**: వివరణాత్మక బ్రాంచ్ పేర్లు ఉపయోగించండి (ఉదా: `fix/typo-module-3`, `add/python-example`)
3. **మార్పులు చేయండి**: కేవలం ఇంగ్లీష్ మార్క్‌డౌన్ ఫైళ్లను సవరించండి (అనువాదాలు కాదు)
4. **లోకల్‌గా పరీక్షించండి**: మార్క్‌డౌన్ సరిగా ప్రదర్శించబడిందనే నిర్ధారించండి
5. **PR సమర్పించండి**: స్పష్టమైన PR శీర్షికలు మరియు వివరణలతో
6. **CLA**: ప్రాంిప్ట్ అయినప్పుడు Microsoft సహకారుల అనుమతి ఒప్పందంపై సంతకం చేయండి

### PR శీర్షిక ఫార్మాట్

స్పష్టమైన, వివరణాత్మక శీర్షికలు ఉపయోగించండి:
- `[Module XX] చిన్న వివరణ` మోడ్యూల్-సంబంధిత మార్పులకు
- `[Samples] వివరణ` నమూనా కోడ్ మార్పులకు
- `[Docs] వివరణ` సాధారణ డాక్యుమెంటేషన్ నవీకరణకు

### ఏం సహకరించాలి

- డాక్యుమెంటేషన్ లేదా కోడ్ నమూనాలలో బగ్ పరిష్కారాలు
- అదనపు భాషలలో కొత్త కోడ్ ఉదాహరణలు
- ఉన్న కంటెంట్‌కు వివరణలు మరియు మెరుగుదలలు
- కొత్త కేస్ స్టడీలు లేదా ప్రాక్టికల్ ఉదాహరణలు
- స్పష్టంగా లేకపోయిన లేదా తప్పు ఉన్న కంటెంట్‌పై సమస్య నివేదికలు

### ఏది చేయరాదు

- `translations/` డైరెక్టరీలో నేరుగా ఫైళ్ళను సవరించవద్దు
- `translated_images/` డైరెక్టరీ సవరించవద్దు
- చర్చ లేకుండా పెద్ద ద్వి-స్థాయి ఫైళ్ళను జోడించవద్దు
- సమన్వయము లేకుండా అనువాద వర్క్‌ఫ్లో ఫైళ్ళను మార్చవద్దు

## అదనపు గమనికలు

### రిపాజిటరీ నిర్వహణ

- **చేంజ్‌లాగ్**: అన్ని ముఖ్యమైన మార్పులు `changelog.md`లో డాక్యుమెంట్ చేయబడ్డాయి
- **స్టడీ గైడ్**: కరుసిలబస్ నావిగేషన్ కోసం `study_guide.md` ఉపయోగించండి
- **ఇష్యూ టెంప్లేట్లు**: బగ్ నివేదికలు మరియు ఫీచర్ అభ్యర్థనల కోసం GitHub ఇష్యూ టెంప్లేట్లను ఉపయోగించండి
- **కోడ్ ఆఫ్ కాన్డక్ట్**: అన్ని సహకారులు Microsoft ఓపెన్ సోర్స్ కోడ్ ఆఫ్ కాన్డక్ట్ అనుసరించాలి

### నేర్చుకునే మార్గం

ఉత్తమ అభ్యాసానికి వరుసగా 00-11 మోడ్యూల్స్ అనుసరించండి:
1. **00-02**: ప్రాథమికాలు (పరిచయం, కోర్ కల్పనలు, భద్రత)
2. **03**: హ్యాండ్స్-ఆన్ అమలు తో ప్రారంభం
3. **04-05**: ప్రాక్టికల్ అమలు మరియు అధిక స్థాయి అంశాలు
4. **06-10**: కమ్యూనిటీ, ఉత్తమ పాలన, మరియు వాస్తవ ప్రపంచ అనువర్తనాలు
5. **11**: సమగ్ర డేటాబేస్ ఏకీకరణ ల్యాబ్స్ (13 వరుస ల్యాబ్స్)

### మద్దతు వనరులు

- **డాక్యుమెంటేషన్**: https://modelcontextprotocol.io/
- **స్పెసిఫికేషన్**: https://spec.modelcontextprotocol.io/
- **కమ్యూనిటీ**: https://github.com/orgs/modelcontextprotocol/discussions
- **డిస్కార్డ్**: Microsoft Foundry Discord సర్వర్
- **సంబంధిత కోర్సులు**: ఇతర Microsoft నేర్చుకునే మార్గాల కోసం README.md చూడండి

### సాధారణ సమస్య పరిష్కారం

**ప్రశ్న: నా PR అనువాద తనిఖీ విఫలమవుతోంది**
జవాబు: మీరు కేవలం మూల మోడ్యూల్ డైరెక్టరీలలోని ఇంగ్లీష్ మార్క్‌డౌన్ ఫైళ్లను మాత్రమే సవరించారంటూ నిర్ధారించండి, అనువాద వేరియంట్లు కాదు.

**ప్రశ్న: నేను కొత్త భాషని ఎలా చేరుస్తాను?**
జవాబు: భాష మద్దతును కో-ఆప్-ట్రాన్స్‌లేటర్ వర్క్‌ఫ్లో ద్వారా నిర్వహిస్తారు. కొత్త భాషలను చేర్చడం గురించి చర్చించడానికి ఒక ఇష్యూ తెరవండి.

**ప్రశ్న: కోడ్ నమూనాలు పని చేయట్లేదు**

A: మీరు నిర్దిష్ట నమూనా READMEలో సెటప్ సూచనలు అనుసరించినట్లుగా ఖచ్చితంగా పరిశీలించండి. మీరు సరైన సంస్కరణల ఆధారాలు ఇన్‌స్టాల్ చేసుకున్నారో లేదో తనిఖీ చేయండి.

**Q: చిత్రాలు ప్రదర్శితం కావడం లేదు**
A: చిత్రం మార్గాలు సాపేక్షంగా ఉండి మరియు ముందుకు తిప్పు స్లాష్‌లు ఉపయోగించాలి అని పరిశీలించండి. చిత్రాలు కాపాడటానికి `images/` డైరెక్టరీలో లేదా స్థానికీకృత సంస్కరణల కోసం `translated_images/` లో ఉండాలి.

### పనితీరు పరిగణనలు

- అనువాద వర్క్‌ఫ్లో పూర్తి కావడానికి కొన్ని నిమిషాలు పట్టవచ్చు
- పెద్ద చిత్రాలను కమిట్ చేయకముందు ఆప్టిమైజ్ చేయాలి
- వ్యక్తిగత మార్క్డౌన్ ఫైళ్లు ఫోకస్డ్ మరియు సరైన పరిమాణంలో ఉంచండి
- మెరుగైన పోర్టబిలిటీ కోసం సాపేక్ష లింకులను ఉపయోగించండి

### ప్రాజెక్ట్ పాలన

ఈ ప్రాజెక్ట్ Microsoft ఓపెన్ సోర్స్ ఆచారాలను అనుసరిస్తుంది:
- కోడ్ మరియు డాక్యుమెంటేషన్ కోసం MIT లైసెన్సు
- Microsoft ఓపెన్ సోర్స్ కోడ్ ఆఫ్ కండక్ట్
- కాంట్రిబ్యూషన్ల కోసం CLA అవసరం
- భద్రతా సమస్యలు: SECURITY.md మార్గదర్శకాలను అనుసరించండి
- మద్దతు: సహాయ వనరుల కోసం SUPPORT.md చూడండి

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**అస్వీకరణ**:
ఈ పత్రం AI అనువాద సేవ [Co-op Translator](https://github.com/Azure/co-op-translator) ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తున్నప్పటికీ, ఆటోమేటెడ్ అనువాదాలు తప్పులు లేదా అసమగ్రతలను కలిగి ఉండవచ్చు. దాని స్వదేశ భాషలో ఉన్న అసలు పత్రాన్ని అధికారం కలిగిన మూలంగా పరిగణించాలి. కీలకమైన సమాచారం కోసం, ప్రొఫెషనల్ మానవ అనువాదాన్ని సిఫారసు చేస్తాము. ఈ అనువాదం ఉపయోగం వల్ల కలిగే ఏవైనా అపార్థాలు లేదా తప్పుదారులు కోసం మేము బాధ్యత వహించము.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->