AI导哈

位置存储服务

一个为AI代理提供持久位置存储的MCP服务器，支持SQLite全文搜索和空间查询。

  • by haksndot
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 haksndot/haksnbot-map

使用说明

haksnbot地图

为AI代理提供持久位置存储的MCP（模型上下文协议）服务器。使用SQLite进行全文搜索，以高效存储和检索具有坐标、标签和空间查询的命名位置。

Haksnbot套件的一部分： 该项目最初是作为 Haksnbot，一个自主的Minecraft机器人。该套件包括五个协同工作的仓库： haksnbot工具 （Minecraft机器人控制）， haksnbot头脑 （自主代理）， haksnbot管理员 （服务器管理）， haksnbot内存 （持久存储器），以及 haksnbot地图 （此仓库位置存储）。每个都可以独立使用，但它们被设计为协同工作。

特性

  • 指定地点 -使用唯一名称存储位置（例如，“spawn”、“my_base”、“nether_hub”）
  • 完整坐标 -X、Y、Z，带尺寸支持（外周、下周、末端）
  • 标签系统 -用灵活的标签组织位置（例如“农场”、“公共”、“危险”）
  • 全文搜索 -使用FTS5按名称、描述或标签查找位置
  • 空间查询 -查找最近的位置，在半径内搜索，计算距离
  • 更抽象的数学 -转换上世界和下世界之间的坐标（÷8或×8）

安装

git clone https://github.com/haksndot/haksnbot-map.git
cd haksnbot-map
npm install

使用Claude代码

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "map": {
      "command": "node",
      "args": ["/path/to/haksnbot-map/src/index.js"]
    }
  }
}

配置

数据库路径可以通过环境变量设置：

{
  "mcpServers": {
    "map": {
      "command": "node",
      "args": ["/path/to/haksnbot-map/src/index.js"],
      "env": {
        "MAP_DB_PATH": "/path/to/locations.db"
      }
    }
  }
}

如果未设置，则默认为 locations.db 在包目录中。

可用工具

核心业务

工具 说明
save_location 使用坐标、尺寸、描述、标记和所有者保存命名位置
get_location 按名称检索特定位置
list_locations 列出所有具有可选维度/所有者筛选的位置
delete_location 删除已保存的位置

搜索和标签

工具 说明
search_locations 在名称、描述和标签之间进行全文搜索
find_by_tags 查找具有特定标签的位置（匹配全部或任何位置）
list_tags 获取所有具有使用次数的唯一标签
add_tags 将标签添加到现有位置
remove_tags 从某个位置删除标签

空间查询

工具 说明
get_distance 计算两点之间的距离（支持名称或原始坐标）
find_nearest 找到离一点最近的N个位置
find_in_radius 查找指定半径内的所有位置
get_nether_coords 转换世界和地狱之间的坐标

统计

工具 说明
get_location_stats 获取概述：总位置、按维度、按所有者、顶部标签

位置结构

每个位置包含：

  • 名字 -位置的唯一标识符（必填，不区分大小写）
  • x、 y，z -坐标（必填）
  • 维度 -overworld、neather或end（默认值：overworld）
  • 描述 -这是什么地方
  • 标签 -分类标签阵列（例如。， ["farm", "public", "wheat"])
  • 所有者 -谁保存了此位置（玩家姓名）
  • created_at / updated_at -时间戳

例子

> Save my base at coordinates 100, 64, -200

> Where is the nether hub?

> What locations are near spawn?

> Find all public farms

> How far is it from my base to the end portal?

> What are the nether coordinates for the witch farm?

需求

  • Node.js 18+

依赖项

相关项目

许可证

麻省理工学院

相关 MCP