# memory_search

> 搜索这个项目的记忆。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/memory/memory_search

> 搜索这个项目的记忆。返回原始记录，不带摘要。q 为空则列出最近的条目；kind 和 tags 是可选的过滤条件。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/memory/memory_search.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | Core (`core`) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定：显式的 `project` → 请求头 → 凭据默认项目 → 工作区默认项目 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `q` | 否 | `string` | 搜索文本，例如 'pricing'。为空则列出最近的记忆。 默认：`""`。 |
| `kind` | 否 | `string` | 只要这个 kind 的记忆，例如 'decision'。 |
| `tags` | 否 | `string[]` | 只要带有这些标签的记忆，例如 ['reddit']。 |
| `limit` | 否 | `integer (≥ 1, ≤ 100)` | 最多返回多少条记忆。默认 50。 |
| `project` | 否 | `string` | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |

## 示例调用

```json
{
  "q": "reddit",
  "kind": "insight",
  "limit": 10
}
```

REST:`POST https://service.opennomos.com/v1/tools/memory_search`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "memory_search"`，以上 JSON 作为 `arguments`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "project": {
    "id": "prj_k3Vd9aQx2",
    "slug": "acme-crm"
  },
  "memories": [
    {
      "id": "mem_Zr81nQw3",
      "kind": "insight",
      "content": "Reddit r/SaaS ignores self-promo; reply with help first.",
      "tags": [
        "reddit",
        "rules"
      ],
      "source": "Claude Code",
      "created_at": "2026-10-16T09:00:00.000Z",
      "updated_at": "2026-10-16T09:00:00.000Z"
    }
  ]
}
```

## 说明

- 这里的查询参数叫 `q`（其他工具用 `query`）。`q` 为空则列出最近的记忆。
- 搜索使用全文匹配，也能匹配中文。修改后立刻就能搜到。
- 搜索按工作区限流（每分钟 120 次，按服务实例计）。

## 错误

被拒绝的调用（输入有误、id 未知、触发限流）返回 `message` 和 `code`；走 MCP 时结果带 `isError: true`。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。