Afferens

io.github.afferens由 GitHub 帳號 afferens 發布v0.2.1更新於 Oct 24, 2026

Real-time physical perception for AI agents — vision, spatial, acoustic, environmental

已驗證STDIO僅桌面資料與分析AI 與機器學習

概覽

AI 產生的概覽

Afferens 是本地 MCP 伺服器,為 AI 助理提供即時物理感知資料:視覺、空間、聲音、環境、分子與節點健康。

可以做什麼
依模態(視覺、空間、聲音、環境、分子、內感受)查詢即時感知事件,支援篩選與數量上限,需 API 金鑰。不需金鑰即可取得涵蓋全部六種模態的示範資料。透過兩次抓取資料來源並回傳標頭、資料年齡與雜湊校驗結果,驗證資料是即時、過期或未變動。
適用情境
當助理需要根據真實世界的即時感測器讀數(例如偵測到的物件、位置、聲音或環境狀況)進行推理,或需要確認某路感測器資料是否確實即時時使用。
執行需求
透過 npm 套件以 npx 作為本機 Node.js 程序執行,也可用 HTTP 模式在可設定的連接埠上供遠端用戶端連線。perceive 與 verify 工具需要環境變數 AFFERENS_API_KEY;示範工具不需金鑰。註冊時提供免費額度。
安裝前請注意
API 金鑰屬於憑證,應避免寫入共用設定或日誌。伺服器會向 Afferens 服務送出查詢,感測器資料與請求資訊會離開本機。verify 工具會兩次抓取資料來源,可能消耗額度或權杖。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Afferens,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@afferens/mcp-server

MCP server for Afferens - real-time physical perception for AI agents.

Use it from local MCP clients over stdio or remote/hosted clients over streamable HTTP. It gives any MCP-compatible AI assistant live sensor data: object detections, positions, sounds, environmental readings, chemical traces, and node health.

Tools

ToolAuthDescription
afferens_demoNoneLive perception data across all 6 modalities. Free, no key needed.
afferens_perceiveAPI keyQuery live events by modality with filtering and limits.
afferens_verifyAPI keyFetch the feed twice and return a proof bundle with headers, age, and a freshness verdict.

Modalities: VISION / SPATIAL / ACOUSTIC / ENVIRONMENTAL / MOLECULAR / INTEROCEPTION

Quick Start

Free tier: 10,000 tokens, no card required. Get your key at afferens.com.

Local MCP Clients

bash
claude mcp add afferens -- npx -y @afferens/mcp-server

Then set your key:

bash
claude mcp add afferens -e AFFERENS_API_KEY=YOUR_KEY -- npx -y @afferens/mcp-server

This stdio setup works for Claude Code, Claude Desktop, Cursor, and Windsurf.

Remote MCP Clients

For hosted or browser-based clients, run Afferens in HTTP mode and point the client at the /mcp endpoint:

bash
AFFERENS_TRANSPORT=http AFFERENS_PORT=8790 AFFERENS_API_KEY=YOUR_KEY node dist/index.js

Then register the endpoint:

json
{  "afferens": {    "url": "http://127.0.0.1:8790/mcp",    "bearer_token_env_var": "AFFERENS_API_KEY"  }}

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

json
{  "mcpServers": {    "afferens": {      "command": "npx",      "args": ["-y", "@afferens/mcp-server"],      "env": {        "AFFERENS_API_KEY": "YOUR_KEY"      }    }  }}

Config file locations:

  • Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Cursor: .cursor/mcp.json in your project root
  • Windsurf: ~/.codeium/windsurf/mcp_config.json

Try it without a key

json
{  "mcpServers": {    "afferens": {      "command": "npx",      "args": ["-y", "@afferens/mcp-server"]    }  }}

Call afferens_demo - no API key needed.

Usage

Once connected, your AI agent can call:

text
afferens_perceive({ modality: "VISION", limit: 5 })

Returns structured perception events your agent can reason over and act on.

For demo verification:

text
afferens_verify({ modality: "VISION", limit: 3, wait_ms: 2000 })

Returns two raw snapshots plus headers, age, and a hash check so you can show whether the feed is live, stale, or unchanged.

Links

License

MIT

來源:README.md,提交 d0f9687

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。