forgetting-engine-mcp 0.4.0__py3-none-any.whl

forgetting_engine_mcp/__init__.py

@@ -0,0 +1,14 @@
+"""
+遗忘引擎 MCP 客户端。
+
+通过 MCP stdio 协议与 Claude Desktop 等 MCP 宿主对接，
+内部转调 gRPC 到 knownot.cc 遗忘引擎服务端。
+
+零本地依赖（无数据库、无 LLM、无引擎逻辑），pip install 即可用。
+
+环境变量：
+  FE_ENDPOINT  — 服务端地址（默认 knownot.cc:50051）
+  FE_API_KEY   — API Key（必填，从 knownot.cc 门户创建）
+"""
+
+__version__ = "0.3.0"

forgetting_engine_mcp/__main__.py

@@ -0,0 +1,17 @@
+"""
+入口：python -m forgetting_engine_mcp / mcp-forgetting-engine
+
+读取环境变量 FE_ENDPOINT / FE_API_KEY，启动 MCP stdio 服务。
+"""
+
+import asyncio
+
+from forgetting_engine_mcp.server import main as _main_async
+
+
+def main():
+    asyncio.run(_main_async())
+
+
+if __name__ == "__main__":
+    main()

forgetting_engine_mcp/proto/forgetting_engine_pb2.py

@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: forgetting_engine/proto/forgetting_engine.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'forgetting_engine/proto/forgetting_engine.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n/forgetting_engine/proto/forgetting_engine.proto\x12\x11\x66orgetting_engine\"-\n\x0b\x46\x65\x61tureItem\x12\x10\n\x08\x63\x61tegory\x18\x01 \x01(\t\x12\x0c\n\x04text\x18\x02 \x01(\t\"\x90\x01\n\nKinProfile\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\r\n\x05roles\x18\x02 \x01(\t\x12\x11\n\tlanguages\x18\x03 \x01(\t\x12\x12\n\nexperience\x18\x04 \x01(\t\x12\x13\n\x0bpreferences\x18\x05 \x01(\t\x12\x13\n\x0braw_profile\x18\x06 \x01(\t\x12\x12\n\nupdated_at\x18\x07 \x01(\t\"i\n\x0bUserProfile\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12\x0e\n\x06traits\x18\x02 \x01(\t\x12\x10\n\x08identity\x18\x03 \x01(\t\x12\x13\n\x0braw_profile\x18\x04 \x01(\t\x12\x12\n\nupdated_at\x18\x05 \x01(\t\";\n\x08Guidance\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x10\n\x08question\x18\x02 \x01(\t\x12\x0f\n\x07options\x18\x03 \x03(\t\"\x81\x01\n\rIngestRequest\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\x0c\n\x04role\x18\x02 \x01(\t\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nsession_id\x18\x04 \x01(\t\x12\x30\n\x08\x66\x65\x61tures\x18\x05 \x03(\x0b\x32\x1e.forgetting_engine.FeatureItem\" \n\x0eIngestResponse\x12\x0e\n\x06msg_id\x18\x01 \x01(\t\"D\n\x0fRetrieveRequest\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\r\n\x05query\x18\x02 \x01(\t\x12\x12\n\nsession_id\x18\x03 \x01(\t\"\xbb\x01\n\x10RetrieveResponse\x12\x32\n\x0bkin_profile\x18\x01 \x01(\x0b\x32\x1d.forgetting_engine.KinProfile\x12\x34\n\x0cuser_profile\x18\x02 \x01(\x0b\x32\x1e.forgetting_engine.UserProfile\x12\x0e\n\x06prompt\x18\x03 \x01(\t\x12-\n\x08guidance\x18\x04 \x03(\x0b\x32\x1b.forgetting_engine.Guidance\"Y\n\x15IngestFeaturesRequest\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\x30\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32\x1e.forgetting_engine.FeatureItem\"\'\n\x16IngestFeaturesResponse\x12\r\n\x05\x63ount\x18\x01 \x01(\x05\"\x14\n\x12GenerateKinRequest\"%\n\x13GenerateKinResponse\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\"\x89\x01\n\x17UpdateKinProfileRequest\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\r\n\x05roles\x18\x02 \x01(\t\x12\x11\n\tlanguages\x18\x03 \x01(\t\x12\x12\n\nexperience\x18\x04 \x01(\t\x12\x13\n\x0bpreferences\x18\x05 \x01(\t\x12\x13\n\x0braw_profile\x18\x06 \x01(\t\"&\n\x18UpdateKinProfileResponse\x12\n\n\x02ok\x18\x01 \x01(\x08\"b\n\x18UpdateUserProfileRequest\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12\x0e\n\x06traits\x18\x02 \x01(\t\x12\x10\n\x08identity\x18\x03 \x01(\t\x12\x13\n\x0braw_profile\x18\x04 \x01(\t\"\'\n\x19UpdateUserProfileResponse\x12\n\n\x02ok\x18\x01 \x01(\x08\"3\n\x10HandshakeRequest\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12\x0e\n\x06kin_id\x18\x02 \x01(\t\"D\n\x11HandshakeResponse\x12\x0e\n\x06kin_id\x18\x01 \x01(\t\x12\x0f\n\x07user_id\x18\x02 \x01(\t\x12\x0e\n\x06is_new\x18\x03 \x01(\x08\x32\xb0\x05\n\x10\x46orgettingEngine\x12M\n\x06Ingest\x12 .forgetting_engine.IngestRequest\x1a!.forgetting_engine.IngestResponse\x12S\n\x08Retrieve\x12\".forgetting_engine.RetrieveRequest\x1a#.forgetting_engine.RetrieveResponse\x12\x65\n\x0eIngestFeatures\x12(.forgetting_engine.IngestFeaturesRequest\x1a).forgetting_engine.IngestFeaturesResponse\x12\\\n\x0bGenerateKin\x12%.forgetting_engine.GenerateKinRequest\x1a&.forgetting_engine.GenerateKinResponse\x12k\n\x10UpdateKinProfile\x12*.forgetting_engine.UpdateKinProfileRequest\x1a+.forgetting_engine.UpdateKinProfileResponse\x12n\n\x11UpdateUserProfile\x12+.forgetting_engine.UpdateUserProfileRequest\x1a,.forgetting_engine.UpdateUserProfileResponse\x12V\n\tHandshake\x12#.forgetting_engine.HandshakeRequest\x1a$.forgetting_engine.HandshakeResponseb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'forgetting_engine.proto.forgetting_engine_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_FEATUREITEM']._serialized_start=70
+  _globals['_FEATUREITEM']._serialized_end=115
+  _globals['_KINPROFILE']._serialized_start=118
+  _globals['_KINPROFILE']._serialized_end=262
+  _globals['_USERPROFILE']._serialized_start=264
+  _globals['_USERPROFILE']._serialized_end=369
+  _globals['_GUIDANCE']._serialized_start=371
+  _globals['_GUIDANCE']._serialized_end=430
+  _globals['_INGESTREQUEST']._serialized_start=433
+  _globals['_INGESTREQUEST']._serialized_end=562
+  _globals['_INGESTRESPONSE']._serialized_start=564
+  _globals['_INGESTRESPONSE']._serialized_end=596
+  _globals['_RETRIEVEREQUEST']._serialized_start=598
+  _globals['_RETRIEVEREQUEST']._serialized_end=666
+  _globals['_RETRIEVERESPONSE']._serialized_start=669
+  _globals['_RETRIEVERESPONSE']._serialized_end=856
+  _globals['_INGESTFEATURESREQUEST']._serialized_start=858
+  _globals['_INGESTFEATURESREQUEST']._serialized_end=947
+  _globals['_INGESTFEATURESRESPONSE']._serialized_start=949
+  _globals['_INGESTFEATURESRESPONSE']._serialized_end=988
+  _globals['_GENERATEKINREQUEST']._serialized_start=990
+  _globals['_GENERATEKINREQUEST']._serialized_end=1010
+  _globals['_GENERATEKINRESPONSE']._serialized_start=1012
+  _globals['_GENERATEKINRESPONSE']._serialized_end=1049
+  _globals['_UPDATEKINPROFILEREQUEST']._serialized_start=1052
+  _globals['_UPDATEKINPROFILEREQUEST']._serialized_end=1189
+  _globals['_UPDATEKINPROFILERESPONSE']._serialized_start=1191
+  _globals['_UPDATEKINPROFILERESPONSE']._serialized_end=1229
+  _globals['_UPDATEUSERPROFILEREQUEST']._serialized_start=1231
+  _globals['_UPDATEUSERPROFILEREQUEST']._serialized_end=1329
+  _globals['_UPDATEUSERPROFILERESPONSE']._serialized_start=1331
+  _globals['_UPDATEUSERPROFILERESPONSE']._serialized_end=1370
+  _globals['_HANDSHAKEREQUEST']._serialized_start=1372
+  _globals['_HANDSHAKEREQUEST']._serialized_end=1423
+  _globals['_HANDSHAKERESPONSE']._serialized_start=1425
+  _globals['_HANDSHAKERESPONSE']._serialized_end=1493
+  _globals['_FORGETTINGENGINE']._serialized_start=1496
+  _globals['_FORGETTINGENGINE']._serialized_end=2184
+# @@protoc_insertion_point(module_scope)

forgetting_engine_mcp/proto/forgetting_engine_pb2_grpc.py

@@ -0,0 +1,374 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from forgetting_engine.proto import forgetting_engine_pb2 as forgetting__engine_dot_proto_dot_forgetting__engine__pb2
+
+GRPC_GENERATED_VERSION = '1.80.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in forgetting_engine/proto/forgetting_engine_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class ForgettingEngineStub(object):
+    """---------------------------------------------------------------------------
+    Service 定义
+    ---------------------------------------------------------------------------
+
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Ingest = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/Ingest',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestResponse.FromString,
+                _registered_method=True)
+        self.Retrieve = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/Retrieve',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveResponse.FromString,
+                _registered_method=True)
+        self.IngestFeatures = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/IngestFeatures',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesResponse.FromString,
+                _registered_method=True)
+        self.GenerateKin = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/GenerateKin',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinResponse.FromString,
+                _registered_method=True)
+        self.UpdateKinProfile = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/UpdateKinProfile',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileResponse.FromString,
+                _registered_method=True)
+        self.UpdateUserProfile = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/UpdateUserProfile',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileResponse.FromString,
+                _registered_method=True)
+        self.Handshake = channel.unary_unary(
+                '/forgetting_engine.ForgettingEngine/Handshake',
+                request_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeRequest.SerializeToString,
+                response_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeResponse.FromString,
+                _registered_method=True)
+
+
+class ForgettingEngineServicer(object):
+    """---------------------------------------------------------------------------
+    Service 定义
+    ---------------------------------------------------------------------------
+
+    """
+
+    def Ingest(self, request, context):
+        """摄入一条对话消息
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def Retrieve(self, request, context):
+        """检索记忆上下文 + Kin画像 + User画像
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def IngestFeatures(self, request, context):
+        """接收客户回传的特征信息，写入加权层
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GenerateKin(self, request, context):
+        """生成新的 kin_id（11 位数字，全局唯一）
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UpdateKinProfile(self, request, context):
+        """更新 Kin（数字公民）画像
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UpdateUserProfile(self, request, context):
+        """更新 User（用户）画像
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def Handshake(self, request, context):
+        """握手配对：Kin_id ←→ User_id
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_ForgettingEngineServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Ingest': grpc.unary_unary_rpc_method_handler(
+                    servicer.Ingest,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestResponse.SerializeToString,
+            ),
+            'Retrieve': grpc.unary_unary_rpc_method_handler(
+                    servicer.Retrieve,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveResponse.SerializeToString,
+            ),
+            'IngestFeatures': grpc.unary_unary_rpc_method_handler(
+                    servicer.IngestFeatures,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesResponse.SerializeToString,
+            ),
+            'GenerateKin': grpc.unary_unary_rpc_method_handler(
+                    servicer.GenerateKin,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinResponse.SerializeToString,
+            ),
+            'UpdateKinProfile': grpc.unary_unary_rpc_method_handler(
+                    servicer.UpdateKinProfile,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileResponse.SerializeToString,
+            ),
+            'UpdateUserProfile': grpc.unary_unary_rpc_method_handler(
+                    servicer.UpdateUserProfile,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileResponse.SerializeToString,
+            ),
+            'Handshake': grpc.unary_unary_rpc_method_handler(
+                    servicer.Handshake,
+                    request_deserializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeRequest.FromString,
+                    response_serializer=forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'forgetting_engine.ForgettingEngine', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('forgetting_engine.ForgettingEngine', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class ForgettingEngine(object):
+    """---------------------------------------------------------------------------
+    Service 定义
+    ---------------------------------------------------------------------------
+
+    """
+
+    @staticmethod
+    def Ingest(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/Ingest',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def Retrieve(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/Retrieve',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.RetrieveResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def IngestFeatures(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/IngestFeatures',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.IngestFeaturesResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GenerateKin(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/GenerateKin',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.GenerateKinResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def UpdateKinProfile(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/UpdateKinProfile',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateKinProfileResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def UpdateUserProfile(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/UpdateUserProfile',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.UpdateUserProfileResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def Handshake(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/forgetting_engine.ForgettingEngine/Handshake',
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeRequest.SerializeToString,
+            forgetting__engine_dot_proto_dot_forgetting__engine__pb2.HandshakeResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

forgetting_engine_mcp/server.py

@@ -0,0 +1,498 @@
+"""
+MCP stdio 服务 — gRPC 代理层。
+
+通过 stdin/stdout JSON-RPC 与 MCP 宿主（Claude Desktop 等）通信，
+内部转调 gRPC 到 knownot.cc 遗忘引擎服务端。
+
+协议：MCP 2024-11-05 / JSON-RPC 2.0
+"""
+
+import asyncio
+import json
+import os
+import sys
+
+import grpc
+
+from forgetting_engine_mcp.proto import forgetting_engine_pb2 as pb
+from forgetting_engine_mcp.proto import forgetting_engine_pb2_grpc as pb_grpc
+
+# ---- Tool 定义 ----
+
+TOOLS = [
+    {
+        "name": "forgetting_engine_ingest",
+        "description": (
+            "摄入一条对话消息到遗忘引擎长期记忆。"
+            "将用户或助手的消息写入持久记忆存储，自动推进 M-Clock。"
+            "可附带 features 回传上次 retrieve 中要求提取的特征信息。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "kin_id": {
+                    "type": "string",
+                    "description": "Kin 标识（11 位数字，全局唯一）",
+                },
+                "role": {
+                    "type": "string",
+                    "enum": ["user", "assistant"],
+                    "description": "角色：user（用户）或 assistant（助手）",
+                },
+                "text": {
+                    "type": "string",
+                    "description": "消息正文",
+                },
+                "session_id": {
+                    "type": "string",
+                    "description": "会话标识",
+                },
+                "features": {
+                    "type": "array",
+                    "description": "客户端回传的特征信息（首次调用可为空）",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "category": {"type": "string"},
+                            "text": {"type": "string"},
+                        },
+                        "required": ["category", "text"],
+                    },
+                },
+            },
+            "required": ["kin_id", "role", "text", "session_id"],
+        },
+    },
+    {
+        "name": "forgetting_engine_handshake",
+        "description": (
+            "握手配对：将您的 User_id 与 Kin_id 建立配对关系。\n\n"
+            "如果您已有 Kin_id，请同时提供 Kin_id 和 User_id。\n"
+            "如果还没有 Kin_id，只需提供 User_id（8 位数字字母组合），引擎会为您生成新的 Kin_id。\n\n"
+            "⚠️ 每个新会话开始时，如果尚未配对，应当先调用此工具。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "user_id": {
+                    "type": "string",
+                    "description": "您的 User_id（8 位数字字母组合）",
+                },
+                "kin_id": {
+                    "type": "string",
+                    "description": "您的 Kin_id（11 位数字）（可选，如无则自动生成）",
+                },
+            },
+            "required": ["user_id"],
+        },
+    },
+    {
+        "name": "forgetting_engine_retrieve",
+        "description": (
+            "从遗忘引擎检索 Kin（数字公民）的长期记忆和画像。\n\n"
+            "返回内容包括：\n"
+            "1. Kin画像（必返）：包含角色、语言、经验、偏好等信息\n"
+            "2. User画像（必返）：包含当前用户的特质和身份信息\n"
+            "3. 相关记忆上下文（按需）：聚焦窗口、最近记事、记忆摘要等\n"
+            "4. 引导问题（仅初次）：未握手配对时返回握手引导\n\n"
+            "⚠️ 收到握手引导后，请调用 forgetting_engine_handshake 工具完成配对。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "kin_id": {
+                    "type": "string",
+                    "description": "Kin 标识（11 位数字，全局唯一）",
+                },
+                "query": {
+                    "type": "string",
+                    "description": "检索查询语句（自然语言，如用户当前的问题）",
+                },
+                "session_id": {
+                    "type": "string",
+                    "description": "可选的会话过滤",
+                },
+            },
+            "required": ["kin_id", "query"],
+        },
+    },
+    {
+        "name": "forgetting_engine_ingest_features",
+        "description": (
+            "接收从 Prompt 末尾 [特征提取请求] 中提取的用户关键特征信息，"
+            "写入加权记忆层。用于单独更新用户画像，不关联具体消息。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "kin_id": {
+                    "type": "string",
+                    "description": "Kin 标识（11 位数字，全局唯一）",
+                },
+                "features": {
+                    "type": "array",
+                    "description": "特征列表",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "category": {"type": "string"},
+                            "text": {"type": "string"},
+                        },
+                        "required": ["category", "text"],
+                    },
+                },
+            },
+            "required": ["kin_id", "features"],
+        },
+    },
+    {
+        "name": "forgetting_engine_generate_kin",
+        "description": (
+            "生成一个新的 kin_id（11 位数字，全局唯一）。\n"
+            "Kin 是数字公民，拥有独立的记忆体和画像。\n"
+            "返回的 ID 需本地留存，下次调用 ingest/retrieve 时作为 kin_id 参数传入。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {},
+            "required": [],
+        },
+    },
+    {
+        "name": "forgetting_engine_update_kin_profile",
+        "description": (
+            "更新 Kin（数字公民）的画像信息。"
+            "在完成身份引导问答后调用此工具，将用户提供的角色、经验、偏好等信息写入Kin画像。"
+            "只能在 retrieve 返回 guidance 不为空时调用。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "kin_id": {
+                    "type": "string",
+                    "description": "Kin 标识（11 位数字）",
+                },
+                "roles": {
+                    "type": "string",
+                    "description": "JSON数组：角色列表",
+                },
+                "languages": {
+                    "type": "string",
+                    "description": "JSON数组：语言列表",
+                },
+                "experience": {
+                    "type": "string",
+                    "description": "经验描述",
+                },
+                "preferences": {
+                    "type": "string",
+                    "description": "JSON对象：偏好键值对",
+                },
+                "raw_profile": {
+                    "type": "string",
+                    "description": "完整画像JSON",
+                },
+            },
+            "required": ["kin_id", "roles"],
+        },
+    },
+    {
+        "name": "forgetting_engine_update_user_profile",
+        "description": (
+            "更新 User（用户自身）的画像信息。记录用户特质和身份。"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "user_id": {
+                    "type": "string",
+                    "description": "User标识（当前用kin_id兼任）",
+                },
+                "traits": {
+                    "type": "string",
+                    "description": "JSON数组：特质列表",
+                },
+                "identity": {
+                    "type": "string",
+                    "description": "身份描述",
+                },
+                "raw_profile": {
+                    "type": "string",
+                    "description": "完整画像JSON",
+                },
+            },
+            "required": ["user_id", "traits"],
+        },
+    },
+]
+
+
+# ---- MCP Server (Stdio Proxy) ----
+
+
+class MCPProxyServer:
+    """MCP 代理服务器：stdio JSON-RPC → gRPC 透传。"""
+
+    def __init__(self, endpoint: str, api_key: str | None = None):
+        self._endpoint = endpoint
+        self._metadata = []
+        if api_key:
+            self._metadata.append(("x-api-key", api_key))
+
+        self._channel = grpc.aio.insecure_channel(endpoint)
+        self._stub = pb_grpc.ForgettingEngineStub(self._channel)
+
+    async def close(self):
+        await self._channel.close()
+
+    # ---- Tool 调用 → gRPC ----
+
+    async def _call_handshake(self, args: dict) -> dict:
+        req = pb.HandshakeRequest(
+            user_id=args["user_id"],
+            kin_id=args.get("kin_id", ""),
+        )
+        try:
+            resp = await self._stub.Handshake(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({
+                "kin_id": resp.kin_id,
+                "user_id": resp.user_id,
+                "is_new": resp.is_new,
+                "message": "配对成功！" if resp.is_new else "握手成功！",
+            }, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() in (grpc.StatusCode.NOT_FOUND, grpc.StatusCode.INVALID_ARGUMENT,
+                             grpc.StatusCode.UNAUTHENTICATED, grpc.StatusCode.PERMISSION_DENIED):
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details()}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def _call_ingest(self, args: dict) -> dict:
+        features = None
+        if args.get("features"):
+            features = [
+                pb.FeatureItem(category=f["category"], text=f["text"])
+                for f in args["features"]
+            ]
+        req = pb.IngestRequest(
+            kin_id=args["kin_id"],
+            role=args["role"],
+            text=args["text"],
+            session_id=args["session_id"],
+            features=features,
+        )
+        try:
+            resp = await self._stub.Ingest(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({"msg_id": resp.msg_id}, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() == grpc.StatusCode.INVALID_ARGUMENT:
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details(), "_status": 422}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def _call_retrieve(self, args: dict) -> dict:
+        req = pb.RetrieveRequest(
+            kin_id=args["kin_id"],
+            query=args["query"],
+            session_id=args.get("session_id") or None,
+        )
+        try:
+            resp = await self._stub.Retrieve(req, metadata=self._metadata)
+        except grpc.AioRpcError as e:
+            if e.code() in (grpc.StatusCode.INVALID_ARGUMENT, grpc.StatusCode.UNAUTHENTICATED,
+                             grpc.StatusCode.PERMISSION_DENIED):
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details()}, ensure_ascii=False)}], "isError": True}
+            raise
+        result = {
+            "kin_profile": {
+                "kin_id": resp.kin_profile.kin_id,
+                "roles": resp.kin_profile.roles,
+                "languages": resp.kin_profile.languages,
+                "experience": resp.kin_profile.experience,
+                "preferences": resp.kin_profile.preferences,
+                "raw_profile": resp.kin_profile.raw_profile,
+            },
+            "user_profile": {
+                "user_id": resp.user_profile.user_id,
+                "traits": resp.user_profile.traits,
+                "identity": resp.user_profile.identity,
+                "raw_profile": resp.user_profile.raw_profile,
+            },
+            "prompt": resp.prompt,
+            "guidance": [
+                {"type": g.type, "question": g.question, "options": list(g.options)}
+                for g in resp.guidance
+            ],
+        }
+        return {"content": [{"type": "text", "text": json.dumps(result, ensure_ascii=False)}]}
+
+    async def _call_ingest_features(self, args: dict) -> dict:
+        features = [
+            pb.FeatureItem(category=f["category"], text=f["text"])
+            for f in args["features"]
+        ]
+        req = pb.IngestFeaturesRequest(
+            kin_id=args["kin_id"],
+            features=features,
+        )
+        try:
+            resp = await self._stub.IngestFeatures(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({"count": resp.count}, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() == grpc.StatusCode.INVALID_ARGUMENT:
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details(), "_status": 422}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def _call_generate_kin(self, _args: dict) -> dict:
+        req = pb.GenerateKinRequest()
+        try:
+            resp = await self._stub.GenerateKin(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({"kin_id": resp.kin_id}, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() == grpc.StatusCode.UNAUTHENTICATED:
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details()}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def _call_update_kin_profile(self, args: dict) -> dict:
+        req = pb.UpdateKinProfileRequest(
+            kin_id=args["kin_id"],
+            roles=args.get("roles", ""),
+            languages=args.get("languages", ""),
+            experience=args.get("experience", ""),
+            preferences=args.get("preferences", ""),
+            raw_profile=args.get("raw_profile", ""),
+        )
+        try:
+            resp = await self._stub.UpdateKinProfile(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({"ok": resp.ok}, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() == grpc.StatusCode.UNAUTHENTICATED:
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details()}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def _call_update_user_profile(self, args: dict) -> dict:
+        req = pb.UpdateUserProfileRequest(
+            user_id=args["user_id"],
+            traits=args.get("traits", ""),
+            identity=args.get("identity", ""),
+            raw_profile=args.get("raw_profile", ""),
+        )
+        try:
+            resp = await self._stub.UpdateUserProfile(req, metadata=self._metadata)
+            return {"content": [{"type": "text", "text": json.dumps({"ok": resp.ok}, ensure_ascii=False)}]}
+        except grpc.AioRpcError as e:
+            if e.code() == grpc.StatusCode.UNAUTHENTICATED:
+                return {"content": [{"type": "text", "text": json.dumps({"error": e.details()}, ensure_ascii=False)}], "isError": True}
+            raise
+
+    async def call_tool(self, name: str, arguments: dict) -> dict:
+        if name == "forgetting_engine_ingest":
+            return await self._call_ingest(arguments)
+        elif name == "forgetting_engine_retrieve":
+            return await self._call_retrieve(arguments)
+        elif name == "forgetting_engine_ingest_features":
+            return await self._call_ingest_features(arguments)
+        elif name == "forgetting_engine_generate_kin":
+            return await self._call_generate_kin(arguments)
+        elif name == "forgetting_engine_handshake":
+            return await self._call_handshake(arguments)
+        elif name == "forgetting_engine_update_kin_profile":
+            return await self._call_update_kin_profile(arguments)
+        elif name == "forgetting_engine_update_user_profile":
+            return await self._call_update_user_profile(arguments)
+        else:
+            raise ValueError(f"未知的 MCP 工具: {name}")
+
+    # ---- JSON-RPC 处理 ----
+
+    async def handle_jsonrpc(self, request: dict) -> dict:
+        req_id = request.get("id")
+        method = request.get("method", "")
+        params = request.get("params", {})
+
+        try:
+            if method == "tools/list":
+                result = {"tools": TOOLS}
+            elif method == "tools/call":
+                tool_name = params.get("name", "")
+                tool_args = params.get("arguments", {})
+                result = await self.call_tool(tool_name, tool_args)
+            elif method == "initialize":
+                result = {
+                    "protocolVersion": "2024-11-05",
+                    "serverInfo": {
+                        "name": "forgetting-engine",
+                        "version": "0.4.0",
+                    },
+                    "capabilities": {"tools": {}},
+                }
+            else:
+                return {
+                    "jsonrpc": "2.0",
+                    "id": req_id,
+                    "error": {"code": -32601, "message": f"未知方法: {method}"},
+                }
+
+            return {"jsonrpc": "2.0", "id": req_id, "result": result}
+
+        except grpc.AioRpcError as e:
+            code = e.code()
+            if code == grpc.StatusCode.UNAUTHENTICATED:
+                msg = "API Key 无效或已停用"
+            elif code == grpc.StatusCode.PERMISSION_DENIED:
+                msg = f"无权访问该 Kin: {e.details()}"
+            else:
+                msg = f"服务端错误: {e.details()}"
+            return {
+                "jsonrpc": "2.0",
+                "id": req_id,
+                "error": {"code": -32000, "message": msg},
+            }
+        except Exception as e:
+            return {
+                "jsonrpc": "2.0",
+                "id": req_id,
+                "error": {"code": -32000, "message": str(e)},
+            }
+
+    # ---- Stdio 循环 ----
+
+    async def run_stdio(self) -> None:
+        loop = asyncio.get_event_loop()
+
+        try:
+            while True:
+                line = await loop.run_in_executor(None, sys.stdin.readline)
+                if not line:
+                    break
+
+                line = line.strip()
+                if not line:
+                    continue
+
+                try:
+                    request = json.loads(line)
+                except json.JSONDecodeError:
+                    continue
+
+                response = await self.handle_jsonrpc(request)
+                output = json.dumps(response, ensure_ascii=False) + "\n"
+                await loop.run_in_executor(None, sys.stdout.write, output)
+                await loop.run_in_executor(None, sys.stdout.flush)
+
+        finally:
+            await self.close()
+
+
+# ---- 入口 ----
+
+
+async def main():
+    endpoint = os.getenv("FE_ENDPOINT", "knownot.cc:50054")
+    api_key = os.getenv("FE_API_KEY", "")
+
+    if not api_key:
+        print("[MCP] 未设置 FE_API_KEY，请求将不携带鉴权信息", file=sys.stderr)
+    else:
+        print(f"[MCP] 连接 {endpoint} (API Key: {api_key[:12]}...)", file=sys.stderr)
+
+    server = MCPProxyServer(endpoint=endpoint, api_key=api_key or None)
+    await server.run_stdio()

forgetting_engine_mcp-0.4.0.dist-info/METADATA

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: forgetting-engine-mcp
+Version: 0.4.0
+Summary: 遗忘引擎 MCP 客户端 — 将 Claude Desktop 连接到 knownot.cc 长期记忆服务
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.80.0
+Requires-Dist: protobuf>=4.21
+
+# 遗忘引擎 MCP 客户端
+
+将 Claude Desktop 连接到 [knownot.cc](https://knownot.cc) 遗忘引擎长期记忆服务。
+
+```
+Claude Desktop ──stdio──→ MCP Proxy ──gRPC──→ knownot.cc:5005x
+```
+
+## 安装
+
+```bash
+pip install forgetting-engine-mcp
+```
+
+## 获取 Kin ID
+
+安装并配置好 MCP 后，在对话中调用：
+
+```
+使用 forgetting_engine_generate_kin 工具
+→ 返回 {"kin_id": "84729105361"}
+```
+
+复制输出的 kin_id 留存，后续 ingest/retrieve 时作为 kin_id 传入。
+
+## 配置
+
+### Claude Desktop
+
+编辑 `claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "forgetting-engine": {
+      "command": "mcp-forgetting-engine",
+      "env": {
+        "FE_ENDPOINT": "knownot.cc:50051",
+        "FE_API_KEY": "fe_ak_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+编辑 `~/.claude.json`：
+
+```json
+{
+  "mcpServers": {
+    "forgetting-engine": {
+      "command": "mcp-forgetting-engine",
+      "env": {
+        "FE_ENDPOINT": "knownot.cc:50051",
+        "FE_API_KEY": "fe_ak_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## 选择实例
+
+| 实例 | FE_ENDPOINT | 说明 |
+|------|-------------|------|
+| 通用版 | `knownot.cc:50051` | allergy, preference, constraint, danger |
+| 护肤增强版 | `knownot.cc:50052` | 通用 + skincare_* |
+| 法律增强版 | `knownot.cc:50053` | 通用 + legal_* |
+| 编程增强版 | `knownot.cc:50054` | 通用 + coding_* |
+
+## 环境变量
+
+| 变量 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `FE_ENDPOINT` | 否 | `knownot.cc:50051` | 遗忘引擎服务端地址 |
+| `FE_API_KEY` | 是 | - | API Key（从 knownot.cc 门户创建） |
+
+## 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `forgetting_engine_generate_kin` | 生成新的 11 位 kin_id |
+| `forgetting_engine_ingest` | 摄入对话消息到长期记忆 |
+| `forgetting_engine_retrieve` | 检索记忆上下文 |
+| `forgetting_engine_ingest_features` | 回传/更新用户特征信息 |
+
+## 支持的 MCP 宿主
+
+| 工具 | 配置文件 | 格式 | 状态 |
+|------|---------|------|------|
+| Claude Code | `~/.claude.json` | JSON | 已验证 |
+| Claude Desktop | `claude_desktop_config.json` | JSON | 已验证 |
+| Cursor | `~/.cursor/mcp.json` | JSON | 已验证 |
+| Codex (OpenAI) | `~/.codex/config.toml` | TOML | 待验证 |
+| Hermes | `~/.hermes/config.yaml` | YAML | 待验证 |
+| OpenCode | `.opencode.json` | JSON/JSONC | 待验证 |
+| OpenClaw | — | — | 不支持 MCP 客户端 |
+
+### Cursor 配置
+
+编辑 `~/.cursor/mcp.json`（全局）或 `.cursor/mcp.json`（项目）：
+
+```json
+{
+  "mcpServers": {
+    "forgetting-engine": {
+      "command": "mcp-forgetting-engine",
+      "env": {
+        "FE_ENDPOINT": "knownot.cc:50051",
+        "FE_API_KEY": "fe_ak_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Codex 配置
+
+编辑 `~/.codex/config.toml`：
+
+```toml
+[mcp_servers.forgetting-engine]
+type = "stdio"
+command = "mcp-forgetting-engine"
+args = []
+
+[mcp_servers.forgetting-engine.env]
+FE_ENDPOINT = "knownot.cc:50051"
+FE_API_KEY = "fe_ak_your_key_here"
+```
+
+### Hermes 配置
+
+编辑 `~/.hermes/config.yaml`：
+
+```yaml
+mcp_servers:
+  forgetting-engine:
+    command: mcp-forgetting-engine
+    env:
+      FE_ENDPOINT: knownot.cc:50051
+      FE_API_KEY: fe_ak_your_key_here
+```
+
+### OpenCode 配置
+
+编辑项目根目录的 `.opencode.json` 或 `~/.opencode.json`：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "forgetting-engine": {
+      "type": "local",
+      "command": ["mcp-forgetting-engine"],
+      "enabled": true,
+      "environment": {
+        "FE_ENDPOINT": "knownot.cc:50051",
+        "FE_API_KEY": "fe_ak_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## 获取 API Key
+
+访问 [knownot.cc](https://knownot.cc) 登录后在 "API Keys" 页面创建 Key。

forgetting_engine_mcp-0.4.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+forgetting_engine_mcp/__init__.py,sha256=GCh1n1rd3LA0p9m9WmtREQqDuEqc18w-8DOav0KPah4,426
+forgetting_engine_mcp/__main__.py,sha256=wUywDPOrf0HTJ8espTh8Xt3fphFLD126WlDWa2qlb8I,310
+forgetting_engine_mcp/server.py,sha256=Kl6zJxREZr-XzNao5aZGXHNkDa1N8W4v5c2t6pULG3Q,19673
+forgetting_engine_mcp/proto/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+forgetting_engine_mcp/proto/forgetting_engine_pb2.py,sha256=0Hs8ENGElZ5aPXJFVuCrpPVMCtu89ghbMTImAdkB-Kc,6743
+forgetting_engine_mcp/proto/forgetting_engine_pb2_grpc.py,sha256=EqoLRfnFrgF3rJa_v831HHKEeiWncWzxgxYnmHy80Hs,16240
+forgetting_engine_mcp-0.4.0.dist-info/METADATA,sha256=tehgCsiVfftlG2RyZNMnKVgUX6khcvk0_U566xZX9xo,4116
+forgetting_engine_mcp-0.4.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+forgetting_engine_mcp-0.4.0.dist-info/entry_points.txt,sha256=fM3WyOfLYYqtSsln2mPV1yXP2q14sR8JnU4EVHg3re0,78
+forgetting_engine_mcp-0.4.0.dist-info/top_level.txt,sha256=HngLBMTu_40m277T5-3NO4uPcysCK68qHSazRIlSm8M,22
+forgetting_engine_mcp-0.4.0.dist-info/RECORD,,

forgetting_engine_mcp-0.4.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

forgetting_engine_mcp-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-forgetting-engine = forgetting_engine_mcp.__main__:main

forgetting_engine_mcp-0.4.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+forgetting_engine_mcp