Statewave

Name: Statewave
Author: smaramwbc

本地服务

github.com/smaramwbc记忆与知识45 天前更新

代码仓库

关于 Statewave

Statewave MCP 服务将 Statewave 记忆功能提供给编码助手、Agent 框架和 IDE 扩展。五个工具可写入事件、搜索并获取主题上下文、浏览时间线及编译记忆；设计不依赖特定厂商，并包含精简的 stdio 传输。

主要功能

01写入并去重事件记录
02按主题搜索记忆
03获取排序后的主题上下文
04浏览可筛选的事件时间线
05编译主题记忆

适用场景

01跨会话保存 Agent 上下文
02为提示词检索相关主题上下文
03按时间查看主题事件记录

MCP 相关

通过精简的 stdio JSON-RPC 2.0 服务，向兼容 MCP 的客户端提供五种 Statewave 记忆工具。它还提供工具列表模式，也可用于现有 MCP 运行时。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@statewavedev/mcp-server

Statewave MCP 服务 — 向兼容 MCP 的客户端（编码助手、Agent 框架、IDE 扩展）公开 Statewave 记忆。

属于 Statewave Connectors 生态系统。设计上不依赖特定供应商 — 不假设使用特定 IDE、模型提供商或托管服务。

内容

STATEWAVE_MCP_TOOLS — 规范的工具接口（5 个工具，输入采用 JSON Schema）
StatewaveClient — 面向 Statewave v1 API 的轻量 HTTP 客户端（身份验证、租户、类型化错误）
dispatchTool — 验证输入的分发器，将工具调用映射到 StatewaveClient 方法
startMcpServer — 精简的 stdio JSON-RPC 2.0 传输，另含 --list-tools 模式

工具

工具	用途
`statewave_ingest_episode`	摄取单个规范化片段（根据 `idempotency_key` 去重）。
`statewave_search_memories`	在某个主题内，通过自由文本查询搜索已编译的记忆。
`statewave_get_context`	为某个主题检索精简、经过排序的上下文 — 在提示词中使用的默认工具。
`statewave_get_timeline`	某个主题的时间顺序片段；可按 `kinds`、`since`、`until` 筛选。
`statewave_compile_subject`	触发某个主题的编译，使新摄取的片段可供回忆。

用法

# As a CLI subcommand (via @statewavedev/connectors-cli)
statewave-connectors mcp start --list-tools     # print the JSON Schema surface and exit
statewave-connectors mcp start                  # stdio JSON-RPC 2.0 server (requires STATEWAVE_URL)

# Or programmatically inside an existing MCP runtime
import { StatewaveClient, dispatchTool } from "@statewavedev/mcp-server";
const client = new StatewaveClient({ url: process.env.STATEWAVE_URL!, apiKey: process.env.STATEWAVE_API_KEY });
const { result } = await dispatchTool(client, "statewave_get_context", {
  subject: "repo:owner/name",
  query: "repo conventions and recent changes",
});