Skip to content

Commit 95b716f

Browse files
authored
Merge pull request #445 from microsoft/update-translations
🌐 Update translations via Co-op Translator
2 parents 79b4c4a + a0d6440 commit 95b716f

File tree

50 files changed

+3200
-2939
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+3200
-2939
lines changed
Lines changed: 65 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,65 @@
1-
<!--
2-
CO_OP_TRANSLATOR_METADATA:
3-
{
4-
"original_hash": "bb55f3119d45c4412fc5555299e60498",
5-
"translation_date": "2025-07-13T22:36:49+00:00",
6-
"source_file": "03-GettingStarted/samples/python/README.md",
7-
"language_code": "ar"
8-
}
9-
-->
10-
# مثال
11-
12-
هذا مثال بلغة بايثون لخادم MCP
13-
14-
إليك كيف يبدو جزء الآلة الحاسبة:
15-
16-
```python
17-
@mcp.tool()
18-
def add(a: float, b: float) -> float:
19-
"""Add two numbers together and return the result."""
20-
return a + b
21-
22-
@mcp.tool()
23-
def subtract(a: float, b: float) -> float:
24-
"""Subtract b from a and return the result."""
25-
return a - b
26-
27-
@mcp.tool()
28-
def multiply(a: float, b: float) -> float:
29-
"""Multiply two numbers together and return the result."""
30-
return a * b
31-
32-
@mcp.tool()
33-
def divide(a: float, b: float) -> float:
34-
"""
35-
Divide a by b and return the result.
36-
37-
Raises:
38-
ValueError: If b is zero
39-
"""
40-
if b == 0:
41-
raise ValueError("Cannot divide by zero")
42-
return a / b
43-
```
44-
45-
## التثبيت
46-
47-
شغّل الأمر التالي:
48-
49-
```bash
50-
pip install mcp
51-
```
52-
53-
## التشغيل
54-
55-
```bash
56-
python mcp_calculator_server.py
57-
```
58-
59-
**إخلاء المسؤولية**:
60-
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.
1+
<!--
2+
CO_OP_TRANSLATOR_METADATA:
3+
{
4+
"original_hash": "f4733f39c05c58e0cf0eee0a8ae7e9a2",
5+
"translation_date": "2025-10-17T20:03:47+00:00",
6+
"source_file": "03-GettingStarted/samples/python/README.md",
7+
"language_code": "ar"
8+
}
9+
-->
10+
# خادم MCP للحاسبة (بايثون)
11+
12+
تنفيذ بسيط لخادم بروتوكول سياق النموذج (MCP) بلغة بايثون يوفر وظائف حاسبة أساسية.
13+
14+
## التثبيت
15+
16+
قم بتثبيت التبعيات المطلوبة:
17+
18+
```bash
19+
pip install -r requirements.txt
20+
```
21+
22+
أو قم بتثبيت MCP Python SDK مباشرة:
23+
24+
```bash
25+
pip install mcp>=1.18.0
26+
```
27+
28+
## الاستخدام
29+
30+
### تشغيل الخادم
31+
32+
تم تصميم الخادم ليتم استخدامه بواسطة عملاء MCP (مثل Claude Desktop). لبدء تشغيل الخادم:
33+
34+
```bash
35+
python mcp_calculator_server.py
36+
```
37+
38+
**ملاحظة**: عند تشغيله مباشرة في نافذة الأوامر، سترى أخطاء التحقق من JSON-RPC. هذا سلوك طبيعي - الخادم ينتظر رسائل عملاء MCP بتنسيق صحيح.
39+
40+
### اختبار الوظائف
41+
42+
لاختبار أن وظائف الحاسبة تعمل بشكل صحيح:
43+
44+
```bash
45+
python test_calculator.py
46+
```
47+
48+
## استكشاف الأخطاء وإصلاحها
49+
50+
### أخطاء الاستيراد
51+
52+
إذا رأيت `ModuleNotFoundError: No module named 'mcp'`، قم بتثبيت MCP Python SDK:
53+
54+
```bash
55+
pip install mcp>=1.18.0
56+
```
57+
58+
### أخطاء JSON-RPC عند التشغيل مباشرة
59+
60+
الأخطاء مثل "Invalid JSON: EOF while parsing a value" عند تشغيل الخادم مباشرة متوقعة. يحتاج الخادم إلى رسائل عملاء MCP، وليس إدخال مباشر من نافذة الأوامر.
61+
62+
---
63+
64+
**إخلاء المسؤولية**:
65+
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالترجمة البشرية الاحترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.
Lines changed: 68 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,68 @@
1-
<!--
2-
CO_OP_TRANSLATOR_METADATA:
3-
{
4-
"original_hash": "bb55f3119d45c4412fc5555299e60498",
5-
"translation_date": "2025-07-13T22:39:22+00:00",
6-
"source_file": "03-GettingStarted/samples/python/README.md",
7-
"language_code": "bg"
8-
}
9-
-->
10-
# Пример
11-
12-
Това е пример на Python за MCP Server
13-
14-
Ето как изглежда частта с калкулатора:
15-
16-
```python
17-
@mcp.tool()
18-
def add(a: float, b: float) -> float:
19-
"""Add two numbers together and return the result."""
20-
return a + b
21-
22-
@mcp.tool()
23-
def subtract(a: float, b: float) -> float:
24-
"""Subtract b from a and return the result."""
25-
return a - b
26-
27-
@mcp.tool()
28-
def multiply(a: float, b: float) -> float:
29-
"""Multiply two numbers together and return the result."""
30-
return a * b
31-
32-
@mcp.tool()
33-
def divide(a: float, b: float) -> float:
34-
"""
35-
Divide a by b and return the result.
36-
37-
Raises:
38-
ValueError: If b is zero
39-
"""
40-
if b == 0:
41-
raise ValueError("Cannot divide by zero")
42-
return a / b
43-
```
44-
45-
## Инсталиране
46-
47-
Изпълнете следната команда:
48-
49-
```bash
50-
pip install mcp
51-
```
52-
53-
## Стартиране
54-
55-
```bash
56-
python mcp_calculator_server.py
57-
```
58-
59-
**Отказ от отговорност**:
60-
Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.
1+
<!--
2+
CO_OP_TRANSLATOR_METADATA:
3+
{
4+
"original_hash": "f4733f39c05c58e0cf0eee0a8ae7e9a2",
5+
"translation_date": "2025-10-17T20:07:31+00:00",
6+
"source_file": "03-GettingStarted/samples/python/README.md",
7+
"language_code": "bg"
8+
}
9+
-->
10+
# MCP Calculator Server (Python)
11+
12+
Прост имплементация на сървър за Model Context Protocol (MCP) на Python, който предоставя основна функционалност на калкулатор.
13+
14+
## Инсталация
15+
16+
Инсталирайте необходимите зависимости:
17+
18+
```bash
19+
pip install -r requirements.txt
20+
```
21+
22+
Или инсталирайте директно MCP Python SDK:
23+
24+
```bash
25+
pip install mcp>=1.18.0
26+
```
27+
28+
29+
## Употреба
30+
31+
### Стартиране на сървъра
32+
33+
Сървърът е предназначен за използване от MCP клиенти (като Claude Desktop). За да стартирате сървъра:
34+
35+
```bash
36+
python mcp_calculator_server.py
37+
```
38+
39+
**Забележка**: Когато го стартирате директно в терминал, ще видите грешки при валидирането на JSON-RPC. Това е нормално поведение - сървърът очаква правилно форматирани съобщения от MCP клиент.
40+
41+
### Тестване на функциите
42+
43+
За да тествате дали функциите на калкулатора работят правилно:
44+
45+
```bash
46+
python test_calculator.py
47+
```
48+
49+
50+
## Отстраняване на проблеми
51+
52+
### Грешки при импортиране
53+
54+
Ако видите `ModuleNotFoundError: No module named 'mcp'`, инсталирайте MCP Python SDK:
55+
56+
```bash
57+
pip install mcp>=1.18.0
58+
```
59+
60+
61+
### Грешки в JSON-RPC при директно стартиране
62+
63+
Грешки като "Invalid JSON: EOF while parsing a value", когато стартирате сървъра директно, са очаквани. Сървърът се нуждае от съобщения от MCP клиент, а не директен вход от терминала.
64+
65+
---
66+
67+
**Отказ от отговорност**:
68+
Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да било недоразумения или погрешни интерпретации, произтичащи от използването на този превод.
Lines changed: 65 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,65 @@
1-
<!--
2-
CO_OP_TRANSLATOR_METADATA:
3-
{
4-
"original_hash": "bb55f3119d45c4412fc5555299e60498",
5-
"translation_date": "2025-07-13T22:37:30+00:00",
6-
"source_file": "03-GettingStarted/samples/python/README.md",
7-
"language_code": "bn"
8-
}
9-
-->
10-
# নমুনা
11-
12-
এটি একটি MCP সার্ভারের জন্য একটি পাইথন নমুনা
13-
14-
ক্যালকুলেটর অংশটি এরকম দেখায়:
15-
16-
```python
17-
@mcp.tool()
18-
def add(a: float, b: float) -> float:
19-
"""Add two numbers together and return the result."""
20-
return a + b
21-
22-
@mcp.tool()
23-
def subtract(a: float, b: float) -> float:
24-
"""Subtract b from a and return the result."""
25-
return a - b
26-
27-
@mcp.tool()
28-
def multiply(a: float, b: float) -> float:
29-
"""Multiply two numbers together and return the result."""
30-
return a * b
31-
32-
@mcp.tool()
33-
def divide(a: float, b: float) -> float:
34-
"""
35-
Divide a by b and return the result.
36-
37-
Raises:
38-
ValueError: If b is zero
39-
"""
40-
if b == 0:
41-
raise ValueError("Cannot divide by zero")
42-
return a / b
43-
```
44-
45-
## ইনস্টল
46-
47-
নিম্নলিখিত কমান্ডটি চালান:
48-
49-
```bash
50-
pip install mcp
51-
```
52-
53-
## চালান
54-
55-
```bash
56-
python mcp_calculator_server.py
57-
```
58-
59-
**অস্বীকৃতি**:
60-
এই নথিটি AI অনুবাদ সেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনূদিত হয়েছে। আমরা যথাসাধ্য সঠিকতার চেষ্টা করি, তবে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল নথিটি তার নিজস্ব ভাষায়ই কর্তৃত্বপূর্ণ উৎস হিসেবে বিবেচিত হওয়া উচিত। গুরুত্বপূর্ণ তথ্যের জন্য পেশাদার মানব অনুবাদ গ্রহণ করার পরামর্শ দেওয়া হয়। এই অনুবাদের ব্যবহারে সৃষ্ট কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যার জন্য আমরা দায়ী নই।
1+
<!--
2+
CO_OP_TRANSLATOR_METADATA:
3+
{
4+
"original_hash": "f4733f39c05c58e0cf0eee0a8ae7e9a2",
5+
"translation_date": "2025-10-17T20:04:47+00:00",
6+
"source_file": "03-GettingStarted/samples/python/README.md",
7+
"language_code": "bn"
8+
}
9+
-->
10+
# MCP ক্যালকুলেটর সার্ভার (Python)
11+
12+
একটি সহজ Model Context Protocol (MCP) সার্ভার যা Python-এ তৈরি এবং মৌলিক ক্যালকুলেটর কার্যকারিতা প্রদান করে।
13+
14+
## ইনস্টলেশন
15+
16+
প্রয়োজনীয় ডিপেন্ডেন্সি ইনস্টল করুন:
17+
18+
```bash
19+
pip install -r requirements.txt
20+
```
21+
22+
অথবা সরাসরি MCP Python SDK ইনস্টল করুন:
23+
24+
```bash
25+
pip install mcp>=1.18.0
26+
```
27+
28+
## ব্যবহার
29+
30+
### সার্ভার চালানো
31+
32+
সার্ভারটি MCP ক্লায়েন্টদের (যেমন Claude Desktop) দ্বারা ব্যবহারের জন্য ডিজাইন করা হয়েছে। সার্ভার চালু করতে:
33+
34+
```bash
35+
python mcp_calculator_server.py
36+
```
37+
38+
**নোট**: সরাসরি টার্মিনালে চালানোর সময়, আপনি JSON-RPC যাচাইকরণ ত্রুটি দেখতে পাবেন। এটি স্বাভাবিক আচরণ - সার্ভার সঠিকভাবে ফরম্যাট করা MCP ক্লায়েন্ট বার্তার জন্য অপেক্ষা করছে।
39+
40+
### ফাংশনগুলো পরীক্ষা করা
41+
42+
ক্যালকুলেটর ফাংশনগুলো সঠিকভাবে কাজ করছে কিনা তা পরীক্ষা করতে:
43+
44+
```bash
45+
python test_calculator.py
46+
```
47+
48+
## সমস্যা সমাধান
49+
50+
### ইমপোর্ট ত্রুটি
51+
52+
যদি আপনি `ModuleNotFoundError: No module named 'mcp'` ত্রুটি দেখেন, তাহলে MCP Python SDK ইনস্টল করুন:
53+
54+
```bash
55+
pip install mcp>=1.18.0
56+
```
57+
58+
### সরাসরি চালানোর সময় JSON-RPC ত্রুটি
59+
60+
"Invalid JSON: EOF while parsing a value" এর মতো ত্রুটি সরাসরি সার্ভার চালানোর সময় প্রত্যাশিত। সার্ভার MCP ক্লায়েন্ট বার্তা প্রয়োজন, সরাসরি টার্মিনাল ইনপুট নয়।
61+
62+
---
63+
64+
**অস্বীকৃতি**:
65+
এই নথিটি AI অনুবাদ পরিষেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার জন্য চেষ্টা করি, তবে অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। এর মূল ভাষায় থাকা নথিটিকে প্রামাণিক উৎস হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য, পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদ ব্যবহারের ফলে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যা হলে আমরা দায়বদ্ধ থাকব না।

0 commit comments

Comments
 (0)