frinus-mcp 3.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Shared types for the Frinus MCP Server.
+ */
+/** Standard MCP tool result content item. */
+export interface ToolResultContent {
+    type: string;
+    text: string;
+}
+/** Standard MCP tool result. Index signature for MCP SDK compatibility. */
+export interface ToolResult {
+    [x: string]: unknown;
+    content: ToolResultContent[];
+    isError?: boolean;
+}
+/** Arguments passed to a tool handler (parsed from MCP request). */
+export type ToolArgs = Record<string, unknown>;
+/** Signature for individual tool handler functions. */
+export type ToolHandler = (args: ToolArgs, deps: ToolHandlerDeps) => Promise<ToolResult>;
+/** Dependencies injected into every tool handler. */
+export interface ToolHandlerDeps {
+    memoryClient: MemoryClientInterface;
+    agentClient: AgentClientInterface;
+    cpClient: CpClientInterface;
+    capture: InteractionCaptureInterface;
+    resolvedUserEmail: string | null;
+    resolvedUserId: string | null;
+    cpUrl: string;
+}
+/** Public surface of the AgentClient used by handlers. */
+export interface AgentClientInterface {
+    createAgent(data: {
+        name: string;
+        template_id?: string;
+        universe_id?: string;
+        persona?: Record<string, unknown>;
+        team_id?: string;
+        is_team_lead?: boolean;
+    }): Promise<any>;
+    listAgents(orgId?: string): Promise<any>;
+    getAgent(agentId: string): Promise<any>;
+    updateAgentPersona(agentId: string, data: {
+        name?: string;
+        personality?: string;
+        instructions?: string;
+        greeting?: string;
+        forbidden_topics?: string[];
+        language?: string;
+        specialization?: string;
+    }): Promise<any>;
+    deleteAgent(agentId: string): Promise<any>;
+    bootstrapAgent(agentId: string): Promise<any>;
+    invokeAgent(data: {
+        agent_id?: string;
+        agent_name?: string;
+        message: string;
+        task_id?: string;
+        context?: Record<string, unknown>;
+        timeout_seconds?: number;
+    }): Promise<any>;
+}
+/** Public surface of the CpClient used by handlers. */
+export interface CpClientInterface {
+    createUniverse(orgId: string, data: {
+        name: string;
+        slug: string;
+        description?: string;
+    }): Promise<any>;
+    listUniverses(orgId: string): Promise<any>;
+    updateUniverse(orgId: string, universeId: string, data: {
+        name?: string;
+        description?: string;
+    }): Promise<any>;
+    deleteUniverse(orgId: string, universeId: string): Promise<void>;
+    storeCredential(integrationRef: string, data: Record<string, unknown>, metadata?: Record<string, unknown>): Promise<any>;
+    getCredential(integrationRef: string): Promise<any>;
+    listCredentials(): Promise<any>;
+    deleteCredential(integrationRef: string): Promise<void>;
+}
+/** Public surface of the MemoryClient used by handlers. */
+export interface MemoryClientInterface {
+    getTenantOrgId(): string | null;
+    getAuthMe(): Promise<any>;
+    startSession(data: {
+        agent_id?: string;
+        parent_session_id?: string;
+    }): Promise<any>;
+    endSession(sessionId: string): Promise<any>;
+    getSessionContext(data: {
+        session_id: string;
+        query: string;
+        agent_id?: string;
+        max_working_memory?: number;
+        max_long_term?: number;
+        include_topics?: boolean;
+    }): Promise<any>;
+    getSessionSummary(sessionId: string): Promise<any>;
+    clearSession(sessionId: string): Promise<any>;
+    storeMemory(data: {
+        agent_id: string;
+        content: string;
+        memory_type?: string;
+        scope?: string;
+        importance?: number;
+        user_id?: string;
+        created_by_user_id?: string;
+        metadata?: Record<string, unknown>;
+        context_id?: string;
+        credential_ref?: string;
+    }): Promise<any>;
+    searchMemories(data: {
+        query_text: string;
+        agent_id?: string;
+        memory_types?: string[];
+        limit?: number;
+    }): Promise<any>;
+    getMemory(memoryId: string): Promise<any>;
+    getAgentMemories(agentId: string, memoryType?: string, limit?: number): Promise<any>;
+    deleteMemory(memoryId: string): Promise<any>;
+    buildContext(data: {
+        agent_id: string;
+        task_description: string;
+        max_tokens?: number;
+    }): Promise<any>;
+    reinforceMemory(memoryId: string, boost?: number): Promise<any>;
+    weakenMemory(memoryId: string, penalty?: number): Promise<any>;
+    getWorkingMemory(contextId: string): Promise<any>;
+    addWorkingMemory(data: {
+        context_id: string;
+        content: string;
+        agent_id?: string;
+        task_id?: string;
+        ttl_seconds?: number;
+    }): Promise<any>;
+    clearWorkingMemory(contextId: string): Promise<any>;
+    captureStream(data: {
+        session_id: string;
+        content: string;
+        direction: string;
+        agent_id?: string;
+        importance?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<any>;
+    getSessionItems(sessionId: string, limit?: number): Promise<any>;
+    getRecentStreamItems(agentId?: string, limit?: number, includeForgotten?: boolean): Promise<any>;
+    processStream(batchSize?: number): Promise<any>;
+    searchWithAttention(data: {
+        query_text: string;
+        task_type?: string;
+        limit?: number;
+        agent_id?: string;
+        user_id?: string;
+    }): Promise<any>;
+    getUserContext(taskDescription: string, userEmail?: string): Promise<any>;
+    heartbeatTick(data: {
+        agent_id?: string;
+        context_id?: string;
+        session_id?: string;
+    }): Promise<any>;
+    reorientAgent(agentId: string, focus?: string): Promise<any>;
+    runSleepCycle(phases?: string[]): Promise<any>;
+    detectConflicts(similarityThreshold?: number, limit?: number): Promise<any>;
+    resolveConflict(data: {
+        keep_id: string;
+        supersede_id: string;
+        resolution_note: string;
+    }): Promise<any>;
+    detectRedundant(similarityThreshold?: number, limit?: number): Promise<any>;
+    hierarchyConsolidate(data: {
+        memory_ids: string[];
+        summary_content?: string;
+        agent_id?: string;
+    }): Promise<any>;
+    getHierarchyTree(memoryId: string): Promise<any>;
+    createConcept(data: {
+        name: string;
+        universe_id: string;
+        description?: string;
+    }): Promise<any>;
+    listUniverseConcepts(universeId: string): Promise<any>;
+    updateConcept(conceptId: string, data: {
+        name?: string;
+        description?: string;
+    }): Promise<any>;
+    deleteConcept(conceptId: string): Promise<any>;
+    createTheme(data: {
+        name: string;
+        concept_id: string;
+        description?: string;
+    }): Promise<any>;
+    listConceptThemes(conceptId: string): Promise<any>;
+    updateTheme(themeId: string, data: {
+        name?: string;
+        description?: string;
+    }): Promise<any>;
+    deleteTheme(themeId: string): Promise<any>;
+    createTopic(data: {
+        name: string;
+        theme_id: string;
+        description?: string;
+        status?: string;
+    }): Promise<any>;
+    listThemeTopics(themeId: string): Promise<any>;
+    updateTopic(topicId: string, data: {
+        name?: string;
+        description?: string;
+    }): Promise<any>;
+    updateTopicStatus(topicId: string, status: string): Promise<any>;
+    deleteTopic(topicId: string): Promise<any>;
+    createPoint(data: {
+        name: string;
+        topic_id: string;
+        description?: string;
+        status?: string;
+    }): Promise<any>;
+    listTopicPoints(topicId: string): Promise<any>;
+    updatePoint(pointId: string, data: {
+        name?: string;
+        description?: string;
+        content?: string;
+    }): Promise<any>;
+    updatePointStatus(pointId: string, status: string): Promise<any>;
+    deletePoint(pointId: string): Promise<any>;
+    getUniverseHierarchy(universeId: string): Promise<any>;
+    trainingTeach(data: {
+        content: string;
+        type?: string;
+        importance?: number;
+        universe_id?: string;
+    }): Promise<any>;
+    trainingQa(data: {
+        pairs: Array<{
+            question: string;
+            answer: string;
+        }>;
+        importance?: number;
+        universe_id?: string;
+    }): Promise<any>;
+    trainingStats(): Promise<any>;
+    trainingGaps(): Promise<any>;
+    trainingRecent(data?: {
+        limit?: number;
+    }): Promise<any>;
+    createTask(data: {
+        title: string;
+        description?: string;
+        assigned_agent_id?: string;
+        parent_task_id?: string;
+        priority?: number;
+        input_data?: Record<string, unknown>;
+    }): Promise<any>;
+    getTask(taskId: string): Promise<any>;
+    listTasks(data?: {
+        status?: string;
+        assigned_agent_id?: string;
+        parent_task_id?: string;
+        limit?: number;
+    }): Promise<any>;
+    updateTask(taskId: string, data: {
+        status?: string;
+        output_data?: Record<string, unknown>;
+        error_message?: string;
+    }): Promise<any>;
+    listSkills(category?: string): Promise<any>;
+    getAgentSkills(agentId: string): Promise<any>;
+    assignSkill(agentId: string, skillId: string, permission?: string): Promise<any>;
+    removeSkill(agentId: string, skillId: string): Promise<any>;
+}
+/** Public surface of InteractionCapture used by the server. */
+export interface InteractionCaptureInterface {
+    sessionId: string;
+    getSessionId(): string;
+    captureToolCall(toolName: string, args: Record<string, unknown>, result: {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError?: boolean;
+    }): void;
+}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+/**
+ * Shared types for the Frinus MCP Server.
+ */
+export {};

package/manifest.json

@@ -0,0 +1,76 @@
+{
+  "manifest_version": "0.2",
+  "name": "frinus",
+  "display_name": "Frinus — Memória Cognitiva",
+  "version": "3.1.0",
+  "description": "Memória cognitiva de longo prazo para o Claude (φρήν + νοῦς). 70 ferramentas de memória, sessões, agentes e conhecimento.",
+  "long_description": "O Frinus dá ao Claude memória de longo prazo, identidade e inteligência persistente entre conversas. Conecta o Claude Desktop à plataforma Frinus (Memory Engine, Control Plane e Agent Service) via MCP. Basta colar sua chave de API pessoal — nada para instalar ou compilar.",
+  "author": {
+    "name": "Frinus",
+    "url": "https://frinus.rdxsec.com.br"
+  },
+  "homepage": "https://frinus.rdxsec.com.br",
+  "documentation": "https://github.com/frinus-ai/frinus-mcp",
+  "support": "https://github.com/frinus-ai/frinus-mcp/issues",
+  "icon": "icon.png",
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "FRINUS_API_KEY": "${user_config.api_key}",
+        "MEMORY_SERVICE_URL": "${user_config.memory_url}",
+        "FRINUS_CP_URL": "${user_config.cp_url}",
+        "AGENT_SERVICE_URL": "${user_config.agent_url}"
+      }
+    }
+  },
+  "user_config": {
+    "api_key": {
+      "type": "string",
+      "title": "Chave de API Frinus",
+      "description": "Sua chave pessoal (sk-frinus-...). Gere em frinus.rdxsec.com.br → Configurações → API Keys.",
+      "sensitive": true,
+      "required": true
+    },
+    "memory_url": {
+      "type": "string",
+      "title": "Memory Engine URL (avançado)",
+      "description": "Deixe o padrão, exceto se usar uma instância própria do Frinus.",
+      "default": "https://frinus-memory.rdxsec.com.br",
+      "required": false
+    },
+    "cp_url": {
+      "type": "string",
+      "title": "Control Plane URL (avançado)",
+      "description": "Deixe o padrão, exceto se usar uma instância própria do Frinus.",
+      "default": "https://frinus-api.rdxsec.com.br",
+      "required": false
+    },
+    "agent_url": {
+      "type": "string",
+      "title": "Agent Service URL (avançado)",
+      "description": "Deixe o padrão, exceto se usar uma instância própria do Frinus.",
+      "default": "https://frinus-agents.rdxsec.com.br",
+      "required": false
+    }
+  },
+  "compatibility": {
+    "claude_desktop": ">=0.10.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "keywords": [
+    "memory",
+    "cognitive",
+    "rag",
+    "frinus",
+    "long-term-memory",
+    "agents"
+  ],
+  "license": "SEE LICENSE IN repository"
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "frinus-mcp",
+  "version": "3.1.0",
+  "description": "Frinus - MCP Server for Cognitive Memory (φρήν + νοῦς). Long-term memory, sessions, agents and knowledge for Claude and any MCP client.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "frinus-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "pack:mcpb": "./scripts/pack-mcpb.sh",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frinus-ai/frinus-mcp.git"
+  },
+  "homepage": "https://frinus.rdxsec.com.br",
+  "bugs": {
+    "url": "https://github.com/frinus-ai/frinus-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "frinus",
+    "memory",
+    "cognitive-memory",
+    "long-term-memory",
+    "rag",
+    "agents",
+    "claude"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "tsx": "^4.19.0"
+  }
+}