MCP সার্ভার · stdio · 0.1.0b4

MCP মেমরি সার্ভার
যা আপনার মেশিনেই চলে।

telys mcp হলো Claude Code, Claude Desktop, Cursor এবং Codex-এর জন্য একটি local stdio MCP মেমরি সার্ভার। আপনার ক্লায়েন্ট এটি subprocess হিসেবে চালু করে — কোনো পোর্ট নেই, কোনো daemon নেই, কোনো ক্লাউড নির্ভরতা নেই। assistant যা সংরক্ষণ করে তা সেশন পেরিয়ে টিকে থাকে, আপনার নিজের ডিস্কে একটি governed store-এ।

শুরু করুন তিনটি কমান্ডে ইনস্টল করুন

01 ইনস্টল

তিনটি কমান্ড। প্রতিটি ক্লায়েন্ট।

SDK টি Apache-2.0। telys login একবার সাইন ইন করে, তারপর signed, device-licensed runtime প্রভিশন ও যাচাই করে — এরপর সার্ভার সম্পূর্ণ অফলাইনে চলে। telys mcp install প্রতিটি ক্লায়েন্টের config-এ সার্ভার এন্ট্রি লেখে: এটি ইনস্টল করা ক্লায়েন্ট স্বয়ংক্রিয়ভাবে শনাক্ত করে, idempotently মার্জ করে এবং স্পর্শ করা যেকোনো ফাইলের ব্যাকআপ রাখে।

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` (একজন ডেভেলপারের জন্য বিনামূল্যে) signed on-device runtime প্রভিশন করে।

02 config এন্ট্রি

শূন্য এনভায়রনমেন্ট। স্ব-নির্ধারণকারী runtime।

প্রতিটি ক্লায়েন্ট একই canonical এন্ট্রি পায়: একমাত্র আর্গুমেন্ট mcp দিয়ে telys চালু করুন। কোনো PYTHONPATH নেই, কোনো kernel path নেই, config-এ কোনো key নেই — runtime যাচাইকৃত telys login ইনস্টল থেকে নিজেই অবস্থান নির্ধারণ করে।

ট্রান্সপোর্ট হলো MCP stdio: stdin/stdout-এর উপর newline-delimited JSON-RPC 2.0, ক্লায়েন্ট process lifecycle পরিচালনা করে। যেখানে ক্লায়েন্টের নিজস্ব CLI তার config ফাইলের মালিক, সেখানে installer সেটির উপর নির্ভর করে — Claude Code-এর জন্য claude mcp add, Codex-এর জন্য codex mcp add।

mcp.json

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

03 assistant যা অর্জন করে

স্থায়ী, অন-ডিভাইস, governed মেমরি।

Persistent

মেমরি সেশন ছাড়িয়ে টিকে থাকে

telys_add-এর মাধ্যমে সংরক্ষিত নোট, সিদ্ধান্ত ও প্রসঙ্গ পরবর্তী সেশনে, পরের সপ্তাহে, ভিন্ন ক্লায়েন্টেও থাকে। store হলো shared state, conversation state নয়।

On-device

আপনার ডিস্কের একটি ডিরেক্টরি

মেমরি ~/.telys/memory-তে থাকে, অথবা $TELYS_MEMORY_PATH যেখানে নির্দেশ করে। Add ও search local engine-এর বিপরীতে in-process চলে — telys login-এর পরে অফলাইন, কোয়েরির সময় কিছুই মেশিন ছাড়ে না।

Governed

স্কোপড, ফিল্টারযোগ্য রিকল

Collection একটি scope key দ্বারা বিভাজিত হয়। Search semantic ও lexical matching একত্রিত করে এবং equality filter গ্রহণ করে — একই ইঞ্জিন যা প্রতিটি SDK কোয়েরিতে explain plan ফেরত দেয়।

টুল	এটি যা করে
telys_search	একটি মেমরি collection-এ semantic + lexical সার্চ। ঐচ্ছিক top_k এবং single-key equality filter।
telys_add	একটি collection-এ টেক্সট ডকুমেন্ট যোগ করে, না থাকলে তৈরি করে। ঐচ্ছিক id এবং প্রতি-ডকুমেন্ট metadata।
telys_create_collection	একটি collection তৈরি করে; partition key ডিফল্টে scope।
telys_list_collections	store-এর collection তালিকা দেখায়।
telys_stats	একটি collection-এর store পরিসংখ্যান।

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 মেমরি সার্ভারযা আপনার মেশিনেই চলে।