LLM-intentions

LLM意向

一个开放的协议和工具包，用于将Android应用程序转换为MCP工具服务器，使用Android Intents作为本机路由层。

状态：Alpha --在真实设备上进行生产运行。通过第二波包络，工具故障不言自明。Multi-CapApp Hub。

这是什么？

LLM Intentions推出了一种新的Android应用程序： CapApp （功能应用程序）。CapApp没有传统的用户界面。它的存在纯粹是为了通过以下方式向LLM公开功能 模型上下文协议（MCP）任何开发人员都可以构建一个。

这 中心 是中央网关。它通过Android Intents发现已安装的CapApps，将它们的工具聚合到一个MCP端点中，并按源对它们进行命名空间。连接任何MCP客户端——Claude、Grok、定制代理——你的手机就会成为人工智能原生设备。

这不是规范或提案。这是一个工作系统。

下一篇：Intent Mesh --用于在同一设备上的多个LLM之间路由工作的实验协议。此仓库中包含早期脚本和规范草案。

不言自明的工具故障

LLM Intentions上的每个工具响应都呈现为规范信封：

OK: contacts_search returned 3 contacts

[
  { "name": "Ada Lovelace", "phone": "+1..." },
  ...
]

FAIL: notify.post failed: SecurityException
Hint: Grant POST_NOTIFICATIONS in Settings → Apps → Notify

Raw:
{ "type": "SecurityException", "message": "..." }

这 Hint: 线来自工具的 toolMetadata { failureMode(pattern, hint) } block——与抛出的异常匹配的正则表达式。当权限被拒绝、API速率限制或传感器不在此设备上时，LLM会看到一个可操作的提示，而不是堆栈跟踪。

CapApp作者可以免费获得：抛出硬错误，声明 failureMode 对于每个已知的故障形状，框架会格式化包络。看 代理商.md 完整的作者合同。

建筑

┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│  Files  │    │ Notify  │    │ People  │    │  Your   │
│  CapApp   │    │  CapApp   │    │  CapApp   │    │  CapApp   │
└────┬────┘    └────┬────┘    └────┬────┘    └────┬────┘
     │              │              │              │
     └──────────────┼──────────────┼──────────────┘
                    │  Android Intents
                    │
     ┌──────────────▼──────────────────────┐
     │         Hub (port 8379)             │
     │    MCP Gateway / Tool Aggregator    │
     │                                     │
     │  ┌───────────┐  ┌────────────────┐  │
     │  │ Discovery │  │  Namespace     │  │
     │  │  Engine   │  │  Router        │  │
     │  └───────────┘  └────────────────┘  │
     └──────────────┬──────────────────────┘
                    │ MCP (streamable-http)
                    ▼
            ┌───────────────┐
            │  MCP Client   │
            │ Claude / Grok │
            │ / Any Agent   │
            └───────────────┘

Intent Mesh——多LLM路由（实验）

状态：早期实验。 脚本可以工作，但工作流程是手动和粗糙的。作为规范草案和概念证明，包括其发展方向。

┌──────────────┐   PROCESS_TEXT    ┌──────────────┐
│    Claude    │ ──── Intent ────> │     Grok     │
│  (Taichi TA) │                   │ (X Firehose) │
│              │ <── Clipboard ─── │              │
└──────────────┘    or xAI API     └──────────────┘
         │                                │
         └────── Intent Mesh ─────────────┘
              Synthesized Alpha Signal

想法是：每个法学硕士都贡献自己最擅长的东西。克劳德通过太极拳进行技术分析。Grok读取实时X/Twitter情绪。Intent Mesh将两者合并。尚未准备好生产，但该概念已得到验证。

什么是CapApp？

CapApp是一个Android APK，它：

1. 暴露MCP工具 通过Android Intents-无需REST API，无需服务器进程
2. 在Hub注册 --Hub通过AndroidMCP协议自动发现它
3. 没有UI --它是一个无头服务，可供LLM调用
4. 本机运行 -完整的Android API访问（文件、联系人、通知、传感器等）

把它想象成一个微服务，但它公开了LLM工具，而不是HTTP端点。它不是容器，而是作为Android应用程序运行。

CapApps示例（包括在内）

内置集线器工具

Termux大桥

termux-mcp 是一个独立的Node.js MCP服务器，在 termux.* 命名空间。它与集线器一起运行，并共享相同的信封线格式。

平台支持

这两个版本都通过wifi在MCP上公开工具，因此您的MCP客户端可以与网络上任何设备上的工具进行通信。相同的协议，每个平台上的本机IPC。

它与移动mcp有何不同

快速开始

先决条件

• 安卓设备 Termux 安装
• 术语：API 附加组件
• Node.js(pkg install nodejs 在Termux）
• LLM意图中心APK已安装
• 已安装一个或多个CapApp APK

1.安装termux mcp

# In Termux
cd ~
git clone https://github.com/dreliq9/llm-intentions.git
cd llm-intentions/termux-mcp
npm install

2.启动服务器

# Terminal 1: termux-mcp (exposes Termux APIs as MCP tools)
node server.js

# Terminal 2: hub-proxy (bridges Hub to MCP clients on :8381)
node hub-proxy.js

3.连接您的MCP客户端

添加到您的MCP客户端配置中（例如。， ~/.mcp.json):

{
  "mcpServers": {
    "hub": {
      "type": "http",
      "url": "http://127.0.0.1:8379/mcp"
    }
  }
}

4.验证

呼叫 hub.status --您应该看到所有发现的CapApps及其工具计数。

构建自己的CapApp

看 容量模板 对于骷髅，你可以叉。

看 代理商.md 对于规范作者合同—— textTool / envelopeTool 助手 toolMetadata DSL和要避免的反模式。

看 spec/capapp-protocol.md 用于完整注册和发现协议。

项目结构

llm-intentions/
├── README.md                 # You are here
├── ARCHITECTURE.md           # Detailed system design
├── AGENTS.md                 # Contract for LLMs and CapApp authors
├── FUTURE.md                 # Roadmap and in-flight work
├── LICENSE                   # Apache 2.0
├── mcp-core/                 # Pure-JVM core: Envelope, ToolRegistry, DSL
├── mcp-intent-api/           # Android lib: ToolAppService, IPC
├── llm-intentions/           # Hub APK
├── tool-device/              # Device sensors, TTS, clipboard CapApp
├── tool-notify/              # Notifications CapApp
├── tool-people/              # Contacts + calendar CapApp
├── tool-files-dev/           # Filesystem CapApp
├── taichi-android/           # Paper crypto trading CapApp
├── termux-mcp/               # Node.js MCP server for Termux APIs
├── hub/                      # hub-proxy Node passthrough
├── intent-mesh/              # Multi-LLM routing (experimental)
├── capapp-template/          # Skeleton for building new CapApps
├── spec/
│   ├── capapp-protocol.md      # How CapApps register and expose tools
│   └── intent-mesh.md        # Multi-LLM routing protocol
└── docs/
    └── prior-art-log.md      # Discovery timeline and prior art

收入和商业资本

LLM Intentions生态系统支持开源和专有CapApps。协议是开放的——构建一个CapApp，保持关闭，出售。Hub不在乎。

对于商业集成或自定义CapApp开发，请打开问题或联系。

许可证

Apache 2.0——请参阅 许可证。包括明确的专利授权。

致谢

建立在 模型上下文协议（MCP） 通过Anthropic。