Frinus MCP Server

Frinus MCP服务器

刹车 + 噪音 --克劳德代理人与…之间的认知记忆桥梁 弗里纳斯 平台。

MCP（模型上下文协议）服务器，公开 70工具 涵盖认知记忆、工作记忆、会话、代理、L0-L3知识层次结构、编排任务和培训管道。服务器使用stdio，由Claude Desktop、Claude Code和任何支持MCP的客户端使用。

• 版本： 3.1.0
• 工具： 70（见 工具参考)
• 后端： 内存引擎(:8001)+控制平面(:8000)+代理服务(:8002)
• 公共镜像： https://github.com/frinus-ai/frinus-mcp

规则零——MCP是强制性的

Frinus MCP 是 代理人的长期记忆、身份和智力。没有它，模型在会话之间是无状态的。每个与Frinus整合的克劳德特工都必须：

1. 验证对话开始时MCP工具是否可用（例如。 session_start, memory_search, search_with_attention).
2. 如果无法访问，请向用户显示警告： *“MCP Frinus未连接。长期内存功能不可用。”*
3. 执行 BOOT协议（P1） 在回答任何非琐碎的问候之前。
4. 通过以下方式持续学习 memory_store 在结束富有成效的会议之前。

完整的协议集存在于全球 CLAUDE.md （Frinus组织），总结如下 7议定书.

需求

• Node.js 18+
• Frinus堆栈可达（内存引擎、控制平面、代理服务）
• 个人API密钥(sk-frinus-...)与租户绑定

安装

npm install
npm run build

该建筑发出 dist/index.js，准备连接到克劳德桌面/Claude代码。

环境变量

生产端点（Frinus SaaS）：

MEMORY_SERVICE_URL=https://frinus-memory.rdxsec.com.br
FRINUS_CP_URL=https://frinus-api.rdxsec.com.br
AGENT_SERVICE_URL=https://frinus-agents.rdxsec.com.br
FRINUS_API_KEY=sk-frinus-...

克劳德桌面/Claude代码配置

将服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "frinus": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"],
      "env": {
        "FRINUS_API_KEY": "sk-frinus-...",
        "MEMORY_SERVICE_URL": "https://frinus-memory.rdxsec.com.br",
        "FRINUS_CP_URL": "https://frinus-api.rdxsec.com.br",
        "AGENT_SERVICE_URL": "https://frinus-agents.rdxsec.com.br"
      }
    }
  }
}

Claude桌面配置路径： ~/.config/claude/claude_desktop_config.json （Linux）/ ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）。 Claude代码配置路径： ~/.claude.json 在...之下 mcpServers.

启动时，服务器通过验证API密钥 /auth/me 并解析租户组织ID+登录用户。失败会中止进程 [FATAL] 因此客户端会显示错误。

7议定书

详细的协议脚本存在于代理的 CLAUDE.md将上表视为每个Frinus综合代理商必须遵守的合同。

工具参考

70个按领域分组的工具。每个工具都返回文本内容；有效载荷跟随MCP Tool spec.完整的JSON模式存在于 src/tools/definitions.ts.

记忆（7）

认知长期记忆：情景（发生了什么）、语义（我知道什么）、程序（如何做事）。

工作记忆（3）

短期、受上下文约束的状态。米勒定律：每个上下文最多7个项目，最古老的自动驱逐。默认TTL 30分钟（最多2小时）。

会议（5）

会话=流、工作内存和捕获的逻辑容器。

流（4）

连续捕获管道。项目被批量处理、评分，重要的项目被提升为永久记忆。

背景与注意力（2）

用户（2）

维护（2）

合并（3）

内存层次结构（2）

代理商（6）

代理CRUD+编排调用。

宇宙（4）

宇宙=租户范围的知识域。保持L0-L3层次结构。

知识层次L0-L3（16）

Universe
  └─ Concept   (L0)  body of knowledge
       └─ Theme  (L1)  thematic split
            └─ Topic   (L2)  unit of work (status: pending / in_progress / completed)
                 └─ Point   (L3)  atomic knowledge unit

每个级别都暴露 create, list, update, delete:

• L0概念: concept_create, concept_list, concept_update, concept_delete
• L1主题: theme_create, theme_list, theme_update, theme_delete
• L2主题: topic_create, topic_list, topic_update, topic_delete
• L3点: point_create, point_list, point_update, point_delete

topic_update 和 point_update 接受a status 这样代理人就可以标记进展。

培训管道（6）

明确地教授系统——事实、程序、问答对、完整的文件。

编排——任务（4）

内存引擎上的任务表驱动多代理编排。

技能（4）

分配给代理的可重用行为。

内存类型

范围

遗产 agent / project / global 望远镜与 project_id宇宙取代了项目，成为组织内部的隔离边界。

最佳实践

内存所需的格式——使未来的检索具有确定性：

• 程序错误 `Bug: . Cause: . Fix: . File:

`

• 图案： `Pattern: . When to use: . File:

`

• 程序： Procedure: . Steps: 1) ... 2) ... 3) .... Caveats:

操作指南：

1. 总是先开机。 呼叫 session_start + working_memory_get + search_with_attention 在回答之前。
2. 使用时加强/削弱。 当回忆起的记忆有帮助时， memory_reinforce当它出错时， memory_weaken （并替换它）。
3. 每2-3圈就抓住一次。 working_memory_add 对于国家来说， stream_capture 对于决策， memory_store 对于结晶的学习。
4. 选对了 task_type. search_with_attention 对每个任务的内存类型进行加权。 debug 喜欢偶发性， documentation 有利于语义， deploy 倾向于程序性。
5. 关闭循环。 结束会话 session_summary + stream_process + session_end.快跑 sleep_run 以便在批次增长时进行更深入的整合。
6. 在混乱累积之前进行审计。 周期性的 consolidation_detect_conflicts + consolidation_detect_redundant 保持清晰的回忆。

建筑

+---------------------+       +------------------+       +----------------------+
| Claude Agent /      |  | Frinus MCP       |  | Memory Engine        |
| Claude Code         | stdio | (this server)    | HTTPS | (memories, sessions, |
+---------------------+       +------------------+       |  hierarchy, tasks)   |
                                |                        +----------------------+
                                |                                  |
                                |                                  v
                                |                        +----------------------+
                                |                        | PostgreSQL+pgvector  |
                                |                        | + Apache AGE (graph) |
                                |                        +----------------------+
                                |
                                +---HTTPS---> Control Plane (universes, orgs)
                                +---HTTPS---> Agent Service (agents, invocation, skills)

• 记忆引擎 拥有记忆、工作记忆、会话、流、L0-L3层次结构、训练、睡眠周期、任务、技能。
• 控制平面 拥有组织、通用、会员、API密钥、账单、凭证、白标签、LLM密钥。
• 代理服务 拥有代理运行时、工具调度、团队路由、角色、调用。

租户隔离是每个租户的数据库。MCP在启动时从API密钥解析您的租户组织ID-您永远不会通过 org_id 手动。

发展

mcp/
  src/
    index.ts                       Entry: MCP server, dispatch, auth bootstrap
    client/
      memory-client.ts             HTTP client + identity state for Memory Engine
      cp-client.ts                 HTTP client for Control Plane
      agent-client.ts              HTTP client for Agent Service
    tools/
      definitions.ts               Tool schemas (70 tools)
      handlers.ts                  Tool handlers (70 handlers)
    capture/
      interaction-capture.ts       Auto stream capture for every tool call
    types/
      index.ts                     Shared types
  dist/                            Compiled output (npm run build)
  package.json
  tsconfig.json

脚本：

npm run build     # tsc to dist/
npm run dev       # tsx hot reload (src/index.ts)
npm start         # node dist/index.js

类型检查：TypeScript 5.6+，ES模块，axios。

许可证

有关许可条款，请参阅存储库根目录。