https://clementgodbarge.com/fa/tag/mcp/MCPHugoBlox Kit (https://hugoblox.com)faTue, 05 May 2026 00:00:00 +0000https://clementgodbarge.com/media/icon_hu_64a6c3bec25b3d7b.pnghttps://clementgodbarge.com/fa/tag/mcp/https://clementgodbarge.com/fa/post/tei-mcp-span-locked/Tue, 05 May 2026 00:00:00 +0000https://clementgodbarge.com/fa/post/tei-mcp-span-locked/<p>وقتی ، هدف این بود که دستیارهای هوش مصنوعی از توهم در نشانه‌گذاری TEI باز بمانند. پایه‌گذاری بر شِما بخشی از مشکل را حل کرد: با دسترسی مستقیم و ابزارمحور به مشخصات P5، مدل دیگر ناچار نیست حدس بزند یک عنصر چه معنایی دارد یا کدام صفت‌ها را می‌پذیرد. خروجی از اعتبارسنجی می‌گذرد.</p> <p>اما توهم در رمزگذاری TEI دو چهره دارد و شِما تنها یکی از آن‌ها را می‌گیرد. اعتبارسنجی در برابر مشخصات به شما می‌گوید که <em>نشانه‌گذاری</em> خوش‌ساخت است. دربارهٔ <em>متنی</em> که نشانه‌گذاری آن را در بر گرفته چیزی نمی‌گوید. و همان‌جا — در خودِ متن — است که توهم‌های زیان‌بارتر لانه می‌کنند. ترکیب بازه‌قفل (span-locked composition)، ویژگی شاخص نسخهٔ v0.3، دقیقاً برای پیشگیری از همین‌ها طراحی شده است.</p> <details class="print:hidden xl:hidden" > <summary>فهرست مطالب</summary> <div class="text-sm"> <nav id="TableOfContents"> <ul> <li><a href="#توهمی-که-شما-نمیتواند-بگیرد">توهمی که شِما نمی‌تواند بگیرد</a></li> <li><a href="#ترکیب-بازهقفل">ترکیب بازه‌قفل</a></li> <li><a href="#این-چه-هست-و-چه-نیست">این چه هست و چه نیست</a></li> <li><a href="#چرا-فراتر-از-tei-هم-اهمیت-دارد">چرا فراتر از TEI هم اهمیت دارد</a></li> <li><a href="#دریافت-بهروزرسانی">دریافت به‌روزرسانی</a></li> </ul> </nav> </div> </details> <h2 id="توهمی-که-شما-نمیتواند-بگیرد">توهمی که شِما نمی‌تواند بگیرد</h2> <p>از مدلی بخواهید نامه‌ای فرانسوی از سدهٔ شانزدهم را رمزگذاری کند و اغلب سند TEI‌ای تحویل می‌گیرید که بی‌عیب می‌نماید. سرآیند پر شده، برچسب‌های <code>&lt;persName&gt;</code> درست نشسته‌اند، <code>&lt;dateline&gt;</code> خوش‌ساخت است. آن را از <code>validate_document</code> بگذرانید؛ قبول می‌شود.</p> <p>حالا بدنه را با متن مبدأ مقایسه کنید.</p> <p><code>mesme</code> شده است <code>même</code>. یک ویرگول جابه‌جا شده. <code>luy</code> بی‌سروصدا به <code>lui</code> امروزی شده. جمله‌ای که در دست‌نویس دشوارخوان بود، به چیزی پاکیزه‌تر «تصحیح» شده. هیچ‌یک از این تغییرها خواسته نشده بود. هیچ‌یک علامت نخورده. سند از نظر شِما معتبر است و در سکوت غلط.</p> <p>برای گردش کار آرشیوی — که در آن متن رمزگذاری‌شده به سند دائمی‌ای بدل می‌شود که خوانندگان بعدی، نمایه‌های جست‌وجو و ارجاع‌ها بر آن تکیه می‌کنند — این همان خطایی است که بیش از همه اهمیت دارد. یک برچسب بدساخت آزاردهنده است. املایی امروزی‌شده که پنج سال کسی متوجهش نشود، تحریف است.</p> <h2 id="ترکیب-بازهقفل">ترکیب بازه‌قفل</h2> <p>نسخهٔ تازه (v0.3) سازوکاری برای پیشگیری از توهم دارد که یک‌راست همین خطا را نشانه رفته است. هدف طراحی این است که توهم در متن بدنه از حیث ساخت ناممکن شود، نه صرفاً نامحتمل.</p> <p>ایده ساده است: <strong>مدل هرگز متن بدنه را تایپ نمی‌کند</strong>.</p> <p>در عوض، گردش کار چنین است:</p> <ol> <li>مدل <code>get_source(&quot;letter_001&quot;)</code> را فرا می‌خواند و متن سادهٔ مبدأ را به‌صورت رشته‌ای تغییرناپذیر دریافت می‌کند.</li> <li>برای هر برچسبی که می‌خواهد به کار ببرد، <code>tag_span(&quot;letter_001&quot;, start, end, element_path, attrs)</code> را فرا می‌خواند — یعنی یک عنصر TEI را در بازه‌ای از نویسه‌ها روی متن مبدأ ثبت می‌کند.</li> <li>وقتی کارش تمام شد، <code>compose(&quot;letter_001&quot;)</code> را فرا می‌خواند. سرور برچسب‌های ثبت‌شده را با متن سادهٔ اصلی درهم می‌بافد، TEI نهایی را می‌سازد و سپس <em>بایت‌به‌بایت</em> وارسی می‌کند که محتوای متنی تختِ سند ساخته‌شده با متن مبدأ برابر است.</li> </ol> <p>اگر بایت‌ها یکی باشند، سند برمی‌گردد. اگر نباشند — اگر برچسب‌های مدل به هر دلیلی بدنه‌ای را ایجاب کنند که حتی یک نویسه با مبدأ تفاوت دارد — <code>compose()</code> به جای تحویل سند تحریف‌شده، خطا می‌دهد.</p> <p>در این گردش کار هیچ مسیری وجود ندارد که مدل از آن سند TEI‌ای بسازد که متن بدنه‌اش با مبدأ فرق کند. این ناوردا مکانیکی است، نه رفتاری. لازم نیست به مدل اعتماد کنید که توهم نزند؛ کافی است به یک مقایسهٔ <code>==</code> میان دو رشتهٔ بایت اعتماد کنید.</p> <h2 id="این-چه-هست-و-چه-نیست">این چه هست و چه نیست</h2> <p>ترکیب بازه‌قفل <strong>مکمل</strong> پایه‌گذاری بر شِماست، نه جانشین آن. ابزارهای پایه‌گذاری بر شِما (<code>validate_document</code>، <code>lookup_element</code>، <code>valid_children</code> و باقی شانزده ابزار اولیه) به مدل کمک می‌کنند TEI <em>معتبر</em> بسازد. ترکیب بازه‌قفل تضمین می‌کند که متن بدنه درون آن TEI به مبدأ <em>وفادار</em> است. یک گردش کار رمزگذاریِ قابل استقرار باید هر دو محور را برآورده کند، و حالا هر دو با یک سرور واحد پوشش داده می‌شوند.</p> <p>نوشدارویی برای همه چیز هم نیست. <code>compose()</code> هنوز بررسی نمی‌کند که برچسب‌های ثبت‌شده بر پایهٔ یک سفارشی‌سازی ODD بارگذاری‌شده مجازند یا نه — این کار بعدی است. برچسب‌های ثبت‌شده در حافظهٔ فرایند می‌مانند و پس از راه‌اندازی مجدد از بین می‌روند. و فایل‌های مبدأ باید از هر جا که سرور اجرا می‌شود خواندنی باشند. همهٔ این‌ها چاره‌پذیرند؛ هیچ‌یک ناوردای اصلی را سست نمی‌کند.</p> <h2 id="چرا-فراتر-از-tei-هم-اهمیت-دارد">چرا فراتر از TEI هم اهمیت دارد</h2> <p>این الگو تعمیم‌پذیر است. هر بار که از مدلی خواسته می‌شود قطعه‌ای متن را حاشیه‌نویسی، تبدیل یا بسته‌بندی کند — و هر بار که سلامت متن زیرین مهم‌تر از توانایی مدل در «بهتر کردن» آن باشد — همین شکل از راه حل کاربرد دارد. از مدل نخواهید متن را دوباره تایپ کند. از آن بخواهید دستورالعمل‌هایی روی متن تولید کند، و بگذارید یک ترکیب‌کنندهٔ قطعی آن‌ها را زیر ناوردای برابری اعمال کند.</p> <p>برای نسخه‌های دیجیتال به‌طور خاص، این تغییر می‌دهد که مسئولانه چه چیزی را می‌توان به مدل سپرد. رمزگذاری ناگهان به کاری بدل می‌شود که می‌توان واگذارش کرد بی‌آنکه ناچار باشید هر خروجی را دستی با مبدأ مقایسه کنید. ماشین راه ملال‌آور را می‌رود؛ مصحح نشانه‌گذاری را بازبینی می‌کند، نه املا را.</p> <h2 id="دریافت-بهروزرسانی">دریافت به‌روزرسانی</h2> <p>اگر tei-mcp را از قبل نصب کرده‌اید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">uvx tei-mcp@latest </span></span></code></pre></div><p>یا از نو:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pip install tei-mcp </span></span></code></pre></div><p>برای استفاده از ترکیب بازه‌قفل، سرور را به پوشه‌ای از فایل‌های متن سادهٔ مبدأ نشانه بروید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">TEI_MCP_SPAN_SOURCE_ROOT</span><span class="o">=</span>/path/to/sources </span></span><span class="line"><span class="cl">uvx tei-mcp </span></span></code></pre></div><p>نام هر فایل بدون پسوند، شناسهٔ سند آن می‌شود (‎<code>letter_001.txt</code> → <code>letter_001</code>‎).</p> <p>کد منبع، مستندات کامل و یادداشت‌های طراحی ناوردا: </p>https://clementgodbarge.com/fa/code/tei-mcp/Sun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/fa/code/tei-mcp/<h2 id="tei-mcp-استاندارد-tei-p5-برای-عاملهای-هوش-مصنوعی">tei-mcp: استاندارد TEI P5 برای عامل‌های هوش مصنوعی</h2> <p>tei-mcp سرور متن‌بازی است که به دستیارهای برنامه‌نویسی هوش مصنوعی دسترسی مستقیم به مشخصات می‌دهد. هوش مصنوعی به جای تکیه بر داده‌های آموزشی به‌خاطرسپرده — که اغلب نشانه‌گذاری موجه‌نما اما نادرست تولید می‌کند — می‌تواند مشخصات را در لحظه پرس‌وجو کند.</p> <h2 id="امکانات">امکانات</h2> <p>سرور ODD استاندارد TEI P5 را تجزیه می‌کند و 16 ابزار در اختیار می‌گذارد:</p> <ul> <li><strong>جست‌وجوی</strong> هر عنصر، کلاس، ماکرو یا پیمانه با نام، بدون حساسیت به حروف بزرگ و کوچک و با پیشنهاد اصلاح غلط‌های تایپی</li> <li><strong>تعیین صفت‌ها</strong> در سراسر سلسله‌مراتب کلاس‌های TEI (محلی + به‌ارث‌رسیده)</li> <li><strong>بسط مدل‌های محتوا</strong> به درخت‌های ساخت‌یافته با تعیین کلاس‌ها و ماکروها</li> <li><strong>اعتبارسنجی تودرتویی</strong> — رابطهٔ مستقیم والد–فرزند یا دسترس‌پذیری بازگشتی با ردیابی مسیر</li> <li><strong>اعتبارسنجی اسناد</strong> در برابر TEI P5: مدل‌های محتوا، صفت‌ها، فهرست‌های بستهٔ مقادیر، یکپارچگی ارجاع‌ها و هشدارهای منسوخ‌شدگی</li> <li><strong>اعتبارسنجی تک‌عنصرها</strong> برای گردش‌های کاری ویرایش تدریجی</li> <li><strong>بارگذاری سفارشی‌سازی‌های ODD</strong> برای محدود کردن شِما به زیرمجموعهٔ خاص یک پروژه</li> <li><strong>جست‌وجو</strong> در همهٔ انواع موجودیت‌ها با الگوهای regex</li> </ul> <h2 id="نصب">نصب</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pip install tei-mcp </span></span></code></pre></div><p>یا اجرای مستقیم با:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">uvx tei-mcp </span></span></code></pre></div><h2 id="کاربرد">کاربرد</h2> <p>به هر کلاینت سازگار با MCP (Claude، Cursor، Windsurf و جز آن) بیفزایید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;mcpServers&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;tei&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;command&#34;</span><span class="p">:</span> <span class="s2">&#34;uvx&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;args&#34;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&#34;tei-mcp&#34;</span><span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><p>کد منبع و مستندات را در بیابید.</p>https://clementgodbarge.com/fa/post/tei-mcp/Sun, 15 Mar 2026 00:00:00 +0000https://clementgodbarge.com/fa/post/tei-mcp/<p>اگر تا به حال با یک دستیار برنامه‌نویسی هوش مصنوعی TEI XML نوشته باشید، احتمالاً دیده‌اید که خراب می‌کند. عنصرها جایی ظاهر می‌شوند که نباید. صفت‌هایی از خود ساخته می‌شوند. قواعد تودرتویی نادیده گرفته می‌شوند. مدل تصوری تقریبی از شکل TEI دارد، اما هیچ شناخت قابل اعتمادی از مشخصات آن ندارد.</p> <p>tei-mcp این مشکل را با دادن دسترسی مستقیم و ابزارمحور به راهنمای TEI P5 به عامل‌های هوش مصنوعی حل می‌کند.</p> <details class="print:hidden xl:hidden" > <summary>فهرست مطالب</summary> <div class="text-sm"> <nav id="TableOfContents"> <ul> <li><a href="#mcp-چیست">MCP چیست؟</a></li> <li><a href="#tei-mcp-چه-میکند">tei-mcp چه می‌کند</a></li> <li><a href="#چرا-اهمیت-دارد">چرا اهمیت دارد</a></li> <li><a href="#شروع-کار">شروع کار</a></li> </ul> </nav> </div> </details> <h2 id="mcp-چیست">MCP چیست؟</h2> <p> (MCP) استانداردی باز است که به برنامه‌های هوش مصنوعی اجازه می‌دهد به منابع داده و ابزارهای بیرونی وصل شوند. آن را چیزی مانند درگاه USB برای هوش مصنوعی تصور کنید: یک پروتکل واحد که هر کلاینت سازگار — Claude، Cursor، Windsurf و دیگران — را به خدمات تخصصی وصل می‌کند.</p> <p>یک سرور MCP <em>ابزارهایی</em> را در اختیار می‌گذارد که هوش مصنوعی می‌تواند در جریان گفت‌وگو فرا بخواند. مدل به جای تکیه بر داده‌های آموزشیِ به‌خاطرسپرده، می‌تواند از منبعی زنده و معتبر پرس‌وجو کند.</p> <h2 id="tei-mcp-چه-میکند">tei-mcp چه می‌کند</h2> <p>tei-mcp مشخصات ODD استاندارد TEI P5 را تجزیه می‌کند و 16 ابزار در اختیار می‌گذارد که رایج‌ترین پرسش‌های یک مصحح یا رمزگذار را پوشش می‌دهند:</p> <ul> <li><strong>این عنصر چیست؟</strong> هر عنصر، کلاس، ماکرو یا پیمانه را با نام جست‌وجو کنید، بدون حساسیت به حروف بزرگ و کوچک و با پیشنهاد اصلاح غلط‌های تایپی.</li> <li><strong>چه صفت‌هایی می‌پذیرد؟</strong> صفت‌ها را در سراسر سلسله‌مراتب کلاس‌ها تعیین کنید — نخست صفت‌های محلی، سپس صفت‌های به‌ارث‌رسیده به ترتیب.</li> <li><strong>چه چیزی می‌تواند درون آن قرار بگیرد؟</strong> مدل‌های محتوا را به درخت‌های ساخت‌یافته بسط دهید، یا فهرستی تخت از فرزندان مجاز بگیرید.</li> <li><strong>آیا این عنصر می‌تواند اینجا بیاید؟</strong> تودرتویی والد–فرزند را بررسی کنید، یا دسترس‌پذیری را در تمام سلسله‌مراتب عنصرها ردیابی کنید.</li> <li><strong>آیا سند من معتبر است؟</strong> یک فایل TEI XML را در برابر مشخصات اعتبارسنجی کنید: مدل‌های محتوا، مقادیر صفت‌ها، فهرست‌های بستهٔ مقادیر، یکپارچگی ارجاع‌ها و هشدارهای منسوخ‌شدگی.</li> <li><strong>شِمای پروژهٔ من چه می‌شود؟</strong> یک فایل سفارشی‌سازی ODD بارگذاری کنید تا همهٔ موارد بالا به زیرمجموعهٔ خاص TEI در پروژهٔ شما محدود شود.</li> </ul> <h2 id="چرا-اهمیت-دارد">چرا اهمیت دارد</h2> <p>رمزگذاری TEI مراجعهٔ مدام به راهنما را می‌طلبد. رمزگذاران باتجربه رایج‌ترین الگوها را از بر می‌کنند، اما حتی آنان هم برای عنصرهای کمتر آشنا یا مدل‌های محتوای پیچیده باید به مشخصات رجوع کنند. برای دستیارهای هوش مصنوعی، که چنین دانش درونی‌شده‌ای ندارند، مشکل بدتر است: نشانه‌گذاری‌ای می‌سازند که موجه می‌نماید اما نادرست است.</p> <p>با tei-mcp، هوش مصنوعی ناچار به حدس زدن نیست. می‌تواند پیش از نوشتن حتی یک براکت زاویه‌دار، پاسخ را در مشخصات بیابد. نتیجه، نشانه‌گذاری‌ای است که با TEI P5 — یا با سفارشی‌سازی ODD پروژهٔ شما — سازگار است.</p> <h2 id="شروع-کار">شروع کار</h2> <p>از PyPI نصب کنید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pip install tei-mcp </span></span></code></pre></div><p>سپس آن را به پیکربندی کلاینت MCP خود بیفزایید:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;mcpServers&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;tei&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;command&#34;</span><span class="p">:</span> <span class="s2">&#34;uvx&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;args&#34;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&#34;tei-mcp&#34;</span><span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><p>سرور در نخستین اجرا مشخصات TEI را دانلود می‌کند و با هر کلاینت سازگار با MCP کار می‌کند.</p> <p>کد منبع و مستندات کامل: </p>