MCP سرور · stdio · 0.1.0b4

MCP memory server
جو آپ کی مشین پر چلتا ہے۔

telys mcp، Claude Code، Claude Desktop، Cursor، اور Codex کے لیے ایک مقامی stdio MCP memory server ہے۔ آپ کا client اسے subprocess کے طور پر چلاتا ہے — نہ port، نہ daemon، نہ cloud پر انحصار۔ assistant جو کچھ محفوظ کرتا ہے وہ sessions کے پار، آپ کی اپنی disk پر ایک governed store میں باقی رہتا ہے۔

شروع کریں تین commands میں install کریں

01 Install

تین commands۔ ہر client۔

SDK، Apache-2.0 ہے۔ telys login آپ کو ایک بار sign in کراتا ہے، پھر signed، device-licensed runtime کو provision اور verify کرتا ہے — اس کے بعد server مکمل طور پر offline چلتا ہے۔ telys mcp install، server entry کو ہر client کی config میں لکھتا ہے: یہ installed clients خود تلاش کرتا ہے، idempotently merge کرتا ہے، اور ہر چھوئی گئی فائل کا backup لیتا ہے۔

shell

pipx install telys   # Apache-2.0 SDK
telys login          # one sign-in → signed device license
telys mcp install    # register the server in your clients
                     # defaults: auto-detect installed clients, user scope

options

telys mcp install
  --client claude|cursor|codex|claude-desktop|all
  --scope  user|project
# defaults: auto-detect installed clients, user scope

پبلک بیٹا — PyPI سے `pipx install telys`، پھر `telys login` (ایک ڈیولپر کے لیے مفت) دستخط شدہ آن-ڈیوائس رن ٹائم فراہم کرتا ہے۔

02 config entry

صفر ماحول۔ خود-تلاش runtime۔

ہر client کو ایک ہی canonical entry ملتی ہے: telys کو واحد argument mcp کے ساتھ چلائیں۔ نہ PYTHONPATH، نہ kernel paths، نہ config میں keys — runtime، verified telys login install سے خود کو تلاش کر لیتا ہے۔

transport، MCP stdio ہے: stdin/stdout پر newline-delimited JSON-RPC 2.0، جس میں client، process lifecycle کا مالک ہے۔ جہاں client کا اپنا CLI اس کی config file کا مالک ہو، installer اس پر چھوڑ دیتا ہے — Claude Code کے لیے claude mcp add، Codex کے لیے codex mcp add۔

mcp.json

{
  "mcpServers": {
    "telys": {
      "command": "telys",
      "args": ["mcp"]
    }
  }
}

03 assistant کو کیا ملتا ہے

مستقل، on-device، governed میموری۔

Persistent

میموری session سے آگے رہتی ہے

telys_add کے ذریعے محفوظ کردہ نوٹس، فیصلے، اور context اگلے session، اگلے ہفتے، کسی دوسرے client میں بھی موجود رہتے ہیں۔ store، shared state ہے، conversation state نہیں۔

On-device

آپ کی disk پر ایک directory

Memories، ~/.telys/memory پر رہتی ہیں، یا جہاں $TELYS_MEMORY_PATH اشارہ کرے۔ Add اور search، مقامی engine کے خلاف in-process چلتے ہیں — telys login کے بعد offline، query کے وقت کچھ بھی مشین نہیں چھوڑتا۔

Governed

Scoped، filterable recall

Collections ایک scope key سے partition ہوتے ہیں۔ Search، semantic اور lexical matching یکجا کرتی ہے اور equality filter قبول کرتی ہے — وہی engine جو ہر SDK query پر explain plan لوٹاتا ہے۔

Tool	کیا کرتا ہے
telys_search	ایک memory collection پر semantic + lexical search۔ اختیاری top_k اور single-key equality filter۔
telys_add	کسی collection میں text documents شامل کریں، نہ ہو تو بنائی جائے۔ اختیاری ids اور per-document metadata۔
telys_create_collection	ایک collection بنائیں؛ partition key بطور ڈیفالٹ scope ہے۔
telys_list_collections	store میں موجود collections کی فہرست دیکھیں۔
telys_stats	کسی collection کے store statistics۔

04 آپریشن

اسے جانچیں۔ اسے ہٹائیں۔

telys mcp status بتاتا ہے کہ سرور کلائنٹ کنفیگز میں کہاں رجسٹرڈ ہے۔ telys mcp uninstall اسے ڈی-رجسٹر کرتا ہے — install جیسے ہی --client اور --scope آپشنز لیتا ہے اور لکھنے سے پہلے ہر کنفیگ کا بیک اپ بناتا ہے۔ وہی میموری ٹولز ٹرمینل سے telys mem کے ذریعے بھی دستیاب ہیں۔

shell

telys mcp                # run the stdio server (what your client launches)
telys mcp status         # where is the server registered?
telys mcp uninstall      # deregister (--client / --scope, as at install)
telys mcp --path <dir>   # point the server at a specific memory root

05 ان کے ساتھ کام کرتا ہے

Claude Code

claude mcp add، یا .mcp.json

User scope سرکاری claude mcp add کے ذریعے رجسٹر ہوتا ہے۔ Project scope ریپوزیٹری روٹ پر ایک صاف، MCP-only .mcp.json لکھتا ہے — کمٹ کرنا محفوظ ہے۔

Claude ڈیسک ٹاپ

claude_desktop_config.json

اندراج کو ایپ کی پلیٹ فارم کنفیگ ڈائریکٹری میں موجود کنفیگ فائل میں ضم کرتا ہے۔ سرور لوڈ کرنے کے لیے Claude Desktop دوبارہ شروع کریں۔

Cursor

~/.cursor/mcp.json

یوزر-لیول mcp.json لکھتا ہے، یا --scope project کے ساتھ پروجیکٹ کے اندر .cursor/mcp.json۔

Codex

codex mcp add، یا config.toml

CLI موجود ہو تو codex mcp add کے ذریعے رجسٹر کرتا ہے؛ بصورتِ دیگر config.toml میں [mcp_servers.telys] بلاک شامل کرتا ہے۔

06 شروع کریں

اپنے MCP کلائنٹ میں Telys شامل کریں۔

Telys پبلک بیٹا (0.1.0b4) میں ہے۔ SDK، PyPI پر Apache-2.0 ہے — pipx install telys، پھر telys login دستخط شدہ آن-ڈیوائس رن ٹائم فراہم کرتا ہے، ایک ڈیولپر کے لیے مفت۔

شروع کریں

MCP memory serverجو آپ کی مشین پر چلتا ہے۔