Arca MCP

MCP搜索检索

提供方 m0nochr0me

搜索检索 stdio · 本地进程 Token 社区 / 第三方 Claude
查看接入方式

Arca MCP是一个提供语义记忆存储和检索的服务,通过向量嵌入实现自然语言查询,支持多租户隔离和逻辑存储桶组织,适用于AI代理和程序集成。

一句话选型结论

按资料字段整理

Arca MCP 属于搜索检索类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

语义搜索Python本地部署向量数据库AI代理多租户记忆存储

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m app

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Arca MCP当前 8 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方m0nochr0me上游标注的维护方 m0nochr0me
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.0 KB
来自项目仓库与上游目录的原文,未做删改

MCP 方舟

一种模型上下文协议(MCP)服务器,通过向量嵌入提供语义记忆存储和检索。使用FastAPI+FastMCP构建,使用LanceDB进行矢量存储,使用Google Gemini进行嵌入生成。

特性

  • 语义搜索 --使用由向量相似性搜索支持的自然语言查询来存储和检索记忆
  • 双重访问 -用于AI代理的MCP工具+用于编程集成的REST API
  • 多租户隔离 --命名空间范围的操作通过 X-Namespace HTTP标头
  • Bucket组织 --将内存分组到逻辑桶中进行结构化存储
  • 嵌入缓存 -用于生成嵌入的Redis-supported缓存,以最大限度地减少API调用
  • 承载令牌认证 --用于安全访问的恒定时间令牌验证

先决条件

  • Python 3.14+
  • 紫外线 包管理器
  • 瑞迪斯
  • Google API密钥(用于Gemini嵌入)

快速开始```bash

Clone the repository

git clone https://github.com/your-org/arca-mcp.git
cd arca-mcp

Install dependencies

uv sync --locked

Configure environment

cp .env.example .env

Edit .env with your ARCA_GOOGLE_API_KEY and ARCA_APP_AUTH_KEY

Run the server

python -m app


服务器启动于 `http://0.0.0.0:4201` 默认情况下,MCP可在 `/app/mcp` 和REST API `/v1`.

## 配置

所有设置都是通过环境变量配置的 `ARCA_` 前缀,或通过 `.env` 文件。

|变量|类型|默认值|描述|
| - | - | - | - |
| `ARCA_APP_HOST` | `str` | `0.0.0.0` |服务器绑定地址|
| `ARCA_APP_PORT` | `int` | `4201` |服务器端口|
| `ARCA_APP_WORKERS` | `int` | `1` |Uvicorn工人人数|
| `ARCA_APP_AUTH_KEY` | `str` | **必需的** |MCP身份验证的承载令牌|
| `ARCA_TRANSPORT` | `str` | `streamable-http` |MCP传输(`stdio`, `http`, `sse`, `streamable-http`) |
| `ARCA_DEBUG` | `bool` | `false` |启用调试模式|
| `ARCA_LOG_MESSAGE_MAX_LEN` | `int` | `2000` |最大日志消息长度|
| `ARCA_GOOGLE_API_KEY` | `str` | **必需的** |Gemini嵌入的Google API密钥|
| `ARCA_EMBEDDING_MODEL` | `str` | `gemini-embedding-001` |Gemini嵌入模型名称|
| `ARCA_EMBEDDING_DIMENSION` | `int` | `3072` |嵌入向量维度|
| `ARCA_VECTOR_STORE_PATH` | `str` | `./lancedb` |LanceDB存储目录|
| `ARCA_REDIS_HOST` | `str` | `localhost` |Redis主机|
| `ARCA_REDIS_PORT` | `int` | `6379` |Redis端口|
| `ARCA_REDIS_DB_CACHE` | `int` | `4` |缓存的Redis数据库编号|
| `ARCA_REDIS_PASSWORD` | `str` | `null` |Redis密码(可选)|
| `ARCA_CACHE_TTL` | `int` | `3600` |默认缓存TTL(秒)(1小时)|
| `ARCA_CACHE_TTL_LONG` | `int` | `604800` |以秒为单位的长缓存TTL(7天,用于嵌入)|

## MCP工具

所有工具都安装在 `memory` 命名空间。操作的作用域为通过提供的命名空间 `X-namespace` HTTP标头(默认为 `"default"`).

### `memory/add`

使用向量嵌入将内容存储在内存中。

参数 · 类型 · 必填 · 说明
`content` · `str` · 是 · 要存储的内容
`bucket` · `str \ · null` · no · 存储桶名称(默认为 `"default"`)
`connected_nodes` · `list[str] \ · null` · 创建时没有要链接的节点的UUID
`relationship_types` · `list[str] \ · null` · 否 · 并行关系标签 `connected_nodes`

**退货:** `{ "status": "Memory added", "memory_id": "" }`

### `memory/get`

通过语义相似性搜索检索记忆。

参数 · 类型 · 必填 · 说明
`query` · `str` · 是 · 自然语言搜索查询
`bucket` · `str \ · null` · 否 · 按桶过滤
`top_k` · `int` · no · 结果数(默认值: `5`)

**退货:** `{ "status": "Memory retrieved", "results": [...] }`

### `memory/delete`

按UUID删除特定内存。

|参数|类型|必填|说明|
| - | - | - | - |
| `memory_id` | `str` |yes |要删除的内存的UUID|

**退货:** `{ "status": "Memory deleted" }`

### `memory/clear`

清空桶里的所有记忆。

参数 · 类型 · 必填 · 说明
`bucket` · `str \ · null` · no · 要清除的Bucket(默认为 `"default"`)

**退货:** `{ "status": "Memories cleared" }`

### `memory/list_buckets`

列出当前命名空间中的所有bucket。

**参数:** 无

**退货:** `{ "buckets": ["default", "work", ...] }`

### `memory/connect`

在两个内存节点之间创建有向边。

|参数|类型|必填|说明|
| - | - | - | - |
| `source_id` | `str` |yes |源节点的UUID|
| `target_id` | `str` |yes |目标节点的UUID|
| `relationship_type` | `str` |是|边缘标签(例如。 `"related_to"`, `"depends_on"`) |

**退货:** `{ "status": "Memories connected" }`

### `memory/disconnect`

删除两个节点之间的一条或所有有向边。

参数 · 类型 · 必填 · 说明
`source_id` · `str` · yes · 源节点的UUID
`target_id` · `str` · yes · 目标节点的UUID
`relationship_type` · `str \ · null` · 否 · 如果提供,仅删除此边缘标签;否则,移除所有边缘

**退货:** `{ "status": "Memories disconnected" }`

### `memory/traverse`

从节点开始遍历知识图。

参数 · 类型 · 必填 · 说明
`memory_id` · `str` · yes · 起始节点的UUID
`relationship_type` · `str \ · null` · no · 筛选此边标签的遍历
`depth` · `int` · no · 跳数(默认值: `1`)

**退货:** `{ "status": "Graph traversed", "results": [...] }` --每个结果包括 `_depth` 现场。

## REST API

所有REST端点都位于 `/v1`,要求a `Authorization: Bearer ` header,并接受可选 `X-Namespace` 标题(默认为 `"default"`).

交互式API文档可在 `/docs` 当服务器正在运行时。

|方法|路径|描述|
| - | - | - |
| `POST` | `/v1/memories` |添加内存|
| `POST` | `/v1/memories/search` |语义相似度搜索|
| `DELETE` | `/v1/memories/{memory_id}` |删除特定内存|
| `DELETE` | `/v1/memories?bucket=...` |桶里的清晰记忆|
| `GET` | `/v1/buckets` |列出所有桶|
| `POST` | `/v1/memories/connect` |在两个节点之间创建有向边|
| `POST` | `/v1/memories/disconnect` |删除两个节点之间的边|
| `GET` | `/v1/memories/{memory_id}/connected` |从节点遍历知识图|

### 例子

所有示例都假设服务器运行在 `localhost:4201`.更换 `$TOKEN` 与你的 `ARCA_APP_AUTH_KEY`.

#### 添加内存```bash
curl -X POST http://localhost:4201/v1/memories \
-H "Authorization: Bearer $TOKEN" \
-H "X-Namespace: my_project" \
-H "Content-Type: application/json" \
-d '{"content": "User prefers dark mode", "bucket": "preferences"}'
``````json
{
"status": "Memory added",
"memory_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

搜索记忆```bash

curl -X POST http://localhost:4201/v1/memories/search \
-H "Authorization: Bearer $TOKEN" \
-H "X-Namespace: my_project" \
-H "Content-Type: application/json" \
-d '{"query": "what theme does the user like?", "top_k": 3}'
``````json
{
"status": "Memory retrieved",
"results": [
{
"memory_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"content": "User prefers dark mode",
"bucket": "preferences"
}
]
}


#### 删除内存```bash
curl -X DELETE http://localhost:4201/v1/memories/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer $TOKEN" \
-H "X-Namespace: my_project"
``````json
{
"status": "Memory deleted"
}

清空一个桶```bash

curl -X DELETE "http://localhost:4201/v1/memories?bucket=preferences" \
-H "Authorization: Bearer $TOKEN" \
-H "X-Namespace: my_project"
``````json
{
"status": "Memories cleared"
}


#### 列出桶```bash
curl http://localhost:4201/v1/buckets \
-H "Authorization: Bearer $TOKEN" \
-H "X-Namespace: my_project"
``````json
{
"buckets": ["default", "preferences", "work"]
}

其他终点

方法 路径 描述
GET / 指数——回报 { "message": "OK" }
GET /health 健康检查——返回状态、版本、正常运行时间、执行ID
GET /docs 交互式OpenAPI文档
* /app/mcp MCP可流式传输http端点

码头工人```bash

Build

docker build -t arca-mcp .

Run

docker run -p 4201:4201 \
-e ARCA_APP_AUTH_KEY=your-secret-key \
-e ARCA_GOOGLE_API_KEY=your-google-api-key \
-e ARCA_REDIS_HOST=host.docker.internal \
arca-mcp


Docker镜像使用Python 3.14 slim和UV进行依赖管理。

## MCP客户端配置

示例 `.mcp.json` 用于连接MCP客户端(例如Claude Code):```json
{
"mcpServers": {
"arca_memory": {
"type": "http",
"url": "http://localhost:4201/app/mcp",
"headers": {
"Authorization": "Bearer ",
"X-namespace": "my_namespace"
}
}
}
}

建筑```text

┌─ /app/mcp → FastMCP Auth → MCP Tool Handler ─┐
Request → FastAPI ├→ Gemini Embedding (Redis cache) → LanceDB
└─ /v1/* → Bearer Auth → REST Router ───────┘
↑
X-Namespace header (multi-tenancy)


### 模块布局```text
app/
├── __main__.py          # Uvicorn entry point
├── main.py              # FastAPI app, lifespan, MCP mount, REST router
├── api/
│   ├── deps.py          # Shared dependencies (auth, namespace extraction)
│   └── memory.py        # REST API router for memory operations
├── context/
│   └── memory.py        # MCP tool definitions (add, get, delete, clear, list_buckets)
├── core/
│   ├── config.py        # Pydantic BaseSettings with ARCA_ env prefix
│   ├── db.py            # LanceDB async connection management
│   ├── cache.py         # Redis cache wrapper
│   ├── ai.py            # Google Gemini AI client
│   └── log.py           # Loguru logging configuration
├── schema/
│   ├── memory.py        # REST API request/response models
│   └── status.py        # Response models (HealthCheckResponse, IndexResponse)
└── util/
├── embeds.py         # Embedding generation with Redis caching
└── memory.py         # Core memory CRUD against LanceDB (PyArrow schema)

技术栈

  • 快速API --ASGI web框架
  • FastMCP --模型上下文协议服务器框架
  • 兰斯数据库 --无服务器矢量数据库
  • 谷歌双子座 --嵌入生成(gemini-embedding-001)
  • 瑞迪斯 --嵌入缓存层
  • 派丹蒂克 --设置和数据验证
  • 紫外线 --Python包管理器
  • 洛古鲁 --日志记录

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Arca MCP 怎么安装?

在客户端按下面的安装命令接入:python -m app。装完在客户端配置里引用同一个包或端点。

Arca MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Arca MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Arca MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Arca MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Arca MCP 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 搜索、多租户、Python、Claude、记忆存储。具体工具清单以官方文档为准。

Arca MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Arca MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。