MCP サーバー · stdio · 0.1.0b4

MCP メモリサーバー、
あなたのマシンで動く。

telys mcp は、Claude Code、Claude Desktop、Cursor、Codex 向けのローカル stdio MCP メモリサーバーです。クライアントがサブプロセスとして起動するため、ポートもデーモンもクラウド依存もありません。アシスタントが保存した内容は、セッションをまたいで、あなた自身のディスク上のガバナンスされたストアに残り続けます。

始める3 つのコマンドでインストール
01 インストール

3 コマンド。すべてのクライアントに対応。

SDK は Apache-2.0 です。telys login で一度サインインすると、署名済みのデバイスライセンスランタイムがプロビジョニングおよび検証されます。以降、サーバーは完全オフラインで動作します。telys mcp install は各クライアントの設定にサーバーエントリを書き込みます。インストール済みクライアントを自動検出し、冪等にマージし、変更するファイルをバックアップします。

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`(開発者1名まで無料)を実行すると、署名済みオンデバイスランタイムがプロビジョニングされます。

02 設定エントリ

環境変数ゼロ。自己配置ランタイム。

すべてのクライアントは同一の標準エントリを使用します。引数 mcp 一つで telys を起動するだけです。PYTHONPATH もカーネルパスも設定内のキーも不要です。ランタイムは検証済みの telys login インストールから自己配置します。

トランスポートは MCP stdio です。stdin/stdout 上の改行区切り JSON-RPC 2.0 で、プロセスライフサイクルはクライアントが管理します。クライアント独自の CLI が設定ファイルを管理する場合、インストーラーはそれに委譲します。Claude Code では claude mcp add、Codex では codex mcp add を使用します。

mcp.json
{
  "mcpServers": {
    "telys": {
      "command": "telys",
      "args": ["mcp"]
    }
  }
}
03 アシスタントが得るもの

永続的、オンデバイス、ガバナンスされたメモリ。

永続的

メモリはセッションを超えて残る

telys_add を通じて保存されたメモ、決定事項、コンテキストは、次のセッション、翌週、別のクライアントでも保持されます。ストアは会話状態ではなく共有状態です。

オンデバイス

あなたのディスク上のディレクトリ

メモリは ~/.telys/memory、または $TELYS_MEMORY_PATH が指す場所に保存されます。追加と検索はローカルエンジンに対してインプロセスで実行されます。telys login 後はオフラインで動作し、クエリ時にマシン外へのデータ送信は一切ありません。

ガバナンス

スコープ付き、フィルタ可能な想起

コレクションはスコープキーでパーティション分割されます。検索はセマンティックマッチングと語彙マッチングを組み合わせ、等値フィルタを受け付けます。すべての SDK クエリで explain プランを返す同一エンジンです。

ツール機能
telys_searchメモリコレクションに対するセマンティック+語彙検索。オプションの top_k と単一キー等値フィルタをサポート。
telys_addコレクションにテキストドキュメントを追加します。コレクションが存在しない場合は作成されます。オプションの ids とドキュメントごとのメタデータをサポート。
telys_create_collectionコレクションを作成します。パーティションキーのデフォルトは scope です。
telys_list_collectionsストア内のコレクションを一覧表示します。
telys_statsコレクションのストア統計を表示します。
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

ユーザースコープは公式の claude mcp add で登録する。プロジェクトスコープはリポジトリルートに MCP 専用のクリーンな .mcp.json を書き込む — コミットしても安全。

Claude Desktop

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 は Apache-2.0 で PyPI に公開されています — pipx install telys、続いて telys login で署名済みオンデバイスランタイムがプロビジョニングされます。開発者1名まで無料。

始める