MCP सर्वर · stdio · 0.1.0b4

MCP memory server
जो आपकी मशीन पर चलता है।

telys mcp, Claude Code, Claude Desktop, Cursor, और Codex के लिए एक local stdio MCP memory server है। आपका client इसे subprocess के रूप में लॉन्च करता है — कोई port नहीं, कोई daemon नहीं, कोई cloud dependency नहीं। assistant जो संग्रहीत करता है वह sessions में बना रहता है, आपकी अपनी disk पर एक governed store में।

शुरू करें तीन कमांड में इंस्टॉल करें

01 इंस्टॉल

तीन कमांड। हर client।

SDK Apache-2.0 है। telys login आपको एक बार साइन इन करता है, फिर signed, device-licensed runtime को provision और verify करता है — उसके बाद server पूरी तरह offline चलता है। telys mcp install प्रत्येक client की config में server entry लिखता है: यह installed clients को auto-detect करता है, 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

Public Beta — PyPI से `pipx install telys`, फिर `telys login` (एक डेवलपर के लिए निःशुल्क) signed on-device runtime provision करता है।

02 config entry

शून्य environment। स्व-स्थानित runtime।

प्रत्येक client को एक ही canonical entry मिलती है: telys को single argument mcp के साथ लॉन्च करें। कोई PYTHONPATH नहीं, कोई kernel paths नहीं, config में कोई keys नहीं — runtime, verified telys login install से स्वयं को locate करता है।

transport MCP stdio है: stdin/stdout पर newline-delimited JSON-RPC 2.0, जिसमें client process lifecycle का स्वामी है। जहाँ client का अपना CLI उसकी config फ़ाइल का स्वामी है, installer उसे defer करता है — Claude Code के लिए claude mcp add, Codex के लिए codex mcp add।

mcp.json

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

03 assistant को क्या मिलता है

स्थायी, on-device, governed memory।

Persistent

Memory session से आगे रहती है

telys_add के ज़रिए संग्रहीत नोट्स, निर्णय और संदर्भ अगले session में, अगले सप्ताह, किसी अन्य client में भी उपलब्ध रहते हैं। store साझा state है, conversation state नहीं।

On-device

आपकी disk पर एक directory

Memories ~/.telys/memory पर, या जहाँ $TELYS_MEMORY_PATH इंगित करे, वहाँ रहती हैं। Add और search local engine के विरुद्ध in-process execute होते हैं — telys login के बाद offline, query के समय कुछ भी मशीन नहीं छोड़ता।

Governed

स्कोप्ड, फ़िल्टर योग्य रिकॉल

Collections एक scope key द्वारा विभाजित होते हैं। 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 आँकड़े।

04 संचालन

इसे जाँचें। इसे हटाएँ।

telys mcp status बताता है कि सर्वर किन client configs में पंजीकृत है। telys mcp uninstall उसे हटाता है — install जैसे ही --client और --scope विकल्पों के साथ, और लिखने से पहले हर config का बैकअप लेता है। वही memory tools टर्मिनल से 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 लिखता है — commit के लिए सुरक्षित।

Claude Desktop

claude_desktop_config.json

प्लेटफ़ॉर्म config डायरेक्टरी में ऐप की config फ़ाइल में entry जोड़ता है। सर्वर लोड करने के लिए Claude Desktop पुनः आरंभ करें।

Cursor

~/.cursor/mcp.json

user-level mcp.json लिखता है, या --scope project के साथ प्रोजेक्ट के अंदर .cursor/mcp.json।

Codex

codex mcp add, या config.toml

CLI उपलब्ध होने पर codex mcp add से पंजीकृत करता है; अन्यथा config.toml में [mcp_servers.telys] ब्लॉक जोड़ता है।

06 शुरू करें

अपने MCP client में Telys जोड़ें।

Telys public beta (0.1.0b4) में है। SDK, PyPI पर Apache-2.0 है — pipx install telys, फिर telys login साइन्ड on-device runtime प्रोविज़न करता है, एक डेवलपर के लिए निःशुल्क।

शुरू करें

MCP memory serverजो आपकी मशीन पर चलता है।