关于 Anwani
Anwani MCP 将 AI Agent 接入 Anwani 的永久九位地址服务。客户端通过 OAuth 管理地址,服务沿用账户现有的权限与额度。
主要功能
- 01创建和列出地址
- 02更新、分享和删除地址
- 03通过 Google OAuth 与 PKCE 登录
- 04创建后锁定地址坐标
- 05查看会话与已授权范围
适用场景
- 01根据提供的地图坐标创建地址
- 02查看账户关联的地址
- 03分享公开地址链接
- 04更新或移除现有地址
MCP 相关
通过 stdio 向兼容 MCP 的客户端提供 Anwani 地址管理工具。项目也列出了远程服务端点供客户端连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemoteclaude mcp add --transport http anwani-app-anwani https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote{"mcpServers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}在 Cursor 中打开{"servers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}在 VS Code 中打开{"mcpServers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}{"mcpServers":{"anwani-app-anwani":{"serverUrl":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote需要授权工具
6此工具无需参数。
详细介绍
Anwani MCP
Anwani MCP 可将 AI Agent 连接到 Anwani。Anwani 是数字地址基础设施,为现实世界中的地点提供永久的 9 位地址码。
通过 OAuth 创建、列出、更新、分享和删除你的 Anwani 地址,使用与 Anwani 各处相同的所有权、权限和账户限额。
兼容 Cursor 和其他兼容 MCP 的客户端。
产品页面:https://9code.app/ai-agents
登录时会在浏览器中使用 Google OAuth + PKCE——授权一次后,客户端便会在此机器上保存令牌。
OAuth 客户端 ID:anwani-cursor
此软件包仅用作连接客户端。其中不包含 Firebase 项目内部信息、Firestore 路径或服务器机密。
要求
- Node.js 18+
- 兼容 MCP 的客户端(支持 Cursor;其他客户端通过 stdio 的使用方式相同)
- Anwani 账户(如果你是新用户,会在 Google 授权时自动创建)
安装
npm install -g anwani-mcp
anwani-mcp-login
或者不进行全局安装:
npx -y anwani-mcp-login
具体流程:
- 本机启动一个本地回调服务器
- 浏览器打开 Anwani 授权页面
- 使用 Google 登录并点击 允许
- 浏览器返回 localhost——桥接程序会自动保存令牌
无需粘贴 JSON。切勿在聊天中粘贴代码或令牌。
备用方式(极少使用):如果网络阻止了环回连接,请运行 anwani-mcp-login --paste。
与 Cursor 配合使用
Cursor 是首个受支持的 MCP 客户端。推荐配置(始终使用已发布的软件包):
{
"mcpServers": {
"anwani": {
"command": "npx",
"args": ["-y", "anwani-mcp"]
}
}
}
然后打开一个新聊天,让 Anwani 创建或更新地址。请提供真实的地图定位点(坐标或 Maps 链接)——Agent 不得捏造地点。
工具
| 工具 | 所需范围 | 说明 |
|---|---|---|
session | — | 连接状态 + 已授权范围(不含内部 ID) |
list_addresses | address:read | 仅列出你的地址 |
create_address | address:create | 需要 idempotency_key + 由你提供的真实经纬度 |
patch_address | address:update | 字段补丁;创建后无法更改坐标 |
share_address | address:share | 公开的 9code.app/code/… 链接 |
delete_address | address:delete | 具有破坏性 |
此客户端不支持上传照片——请使用 Anwani 应用或 Telegram 上传照片。
安全
- 令牌存储在
~/.anwani-mcp/中(绝不会存放在此软件包内)。 - 访问令牌是不可解析的
anwani_at_…值。 - 账户配额与应用 / Telegram 相同(通常为 10 个地址)。
- 再次运行登录即可撤销(重新授权会使之前的令牌失效),也可以发送邮件至 [email protected]。
从源码安装
git clone https://github.com/Anwani-app/anwani-mcp.git
cd anwani-mcp
node login.mjs
冒烟测试
在克隆的仓库中运行:
node smoke.mjs
发布 / 目录
有关 Official MCP Registry、Glama、Smithery 和 npm 的信息,请参阅 PUBLISH.md。
- 本地(任何 MCP 客户端,例如 Cursor):在运行
anwani-mcp-login后执行npx -y anwani-mcp - 远程:
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。