AutoSugges

io.github.autosugges由 GitHub 账号 autosugges 发布v0.1.1更新于 Oct 29, 2026

Autocomplete over edge-served reference lists (countries, NAICS, airports), plus catalog and setup.

概览

AI 生成的概览

AutoSugges MCP 服务器,让助手对边缘托管的参考列表(国家、NAICS 行业代码、机场等)做自动补全,并浏览数据集目录。

可以做什么
  • 用单个查询词检索某个参考列表,返回排序且数量受限的自动补全建议。
  • 浏览平台数据集目录,含 slug、名称、描述、分类、可用性与权威来源。
  • 按 slug 查看单个数据集的元数据与文档链接。
  • 获取将 AutoSugges 集成到框架或调用运行时端点的、可直接交给智能体使用的说明。
适用场景
适合在构建表单或集成时,让助手解析或推荐规范参考值(国家名、行业代码、机场、货币),或需要 AutoSugges 客户端的接入指引时使用。不适合枚举完整列表或获取数据集条目。
运行要求
以 stdio 本地运行 npm 包 @autosugges/mcp(需 Node.js)。需在环境变量 AUTOSUGGES_PUBLISHABLE_KEY 中提供发布密钥(可在 AutoSugges 应用免费获取),它决定检索哪个列表;AUTOSUGGES_RUNTIME_URL 指定运行时源。需要访问 AutoSugges 运行时的网络连接。
安装前请注意
发布密钥是通过环境变量传入的凭据;README 称发布密钥可安全用于浏览器,并绑定站点来源。搜索仅针对单次查询返回建议,无法枚举列表;数据集工具只返回元数据,不返回条目。查询内容会发送到 AutoSugges 运行时。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AutoSugges,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@autosugges/client

AutoSugges: edge autocomplete API + free reference datasets (countries, NAICS, airports, currencies…) behind one React / React Native / HTML component.

[npm] [license]

Docs: https://docs.autosugges.com · Datasets: https://autosugges.com

sh
npm i @autosugges/client

Replace YOUR_PUBLISHABLE_KEY with a free key from https://app.autosugges.com — one key per list, locked to your site's origins. Publishable keys are safe in a browser.

React / Next.js

tsx
'use client';import { useState } from 'react';import { AutoSugges } from '@autosugges/client/react';import { AutosuggesProvider, type AutoSuggesValue } from '@autosugges/client/react-core';
export function CountryField() {  const [country, setCountry] = useState<AutoSuggesValue>(null);  return (    <AutosuggesProvider lists={{ countries: 'YOUR_PUBLISHABLE_KEY' }}>      <AutoSugges list="countries" value={country} onChange={setCountry} />    </AutosuggesProvider>  );}

value is the full selected item (an array for multi-select lists). Behaviour — minimum characters, debounce, creatable items, multi-select — comes from the list's server policy; overrides can only narrow it.

Expo / React Native

tsx
import { AutoSugges } from '@autosugges/client/native-ui';import { AutosuggesProvider } from '@autosugges/client/react-core';// same props as web: <AutoSugges list="countries" value={value} onChange={setValue} />

Optional peers for the bottom-sheet presentation: @gorhom/bottom-sheet, react-native-gesture-handler, react-native-reanimated.

Plain HTML

html
<script src="https://cdn.jsdelivr.net/npm/@autosugges/client/dist/browser/autosugges.js"></script><input  data-autosugges-key="YOUR_PUBLISHABLE_KEY"  data-autosugges-base-url="https://runtime.autosugges.com"  data-autosugges-placeholder="Country"/>

Self-hosted copy with an SRI hash: https://autosugges.com/sdk/v1/autosugges.js. Other attributes: data-autosugges-theme (light|dark), -locale, -label, -parent, -access-token. Call window.AutoSugges.autoInit() after injecting markup later.

Entry points

. (client, combobox state machine) · ./react · ./react-core · ./native · ./native-ui · ./browser. Style it with CSS custom properties (--as-color-text, --as-font-sans, …); see the docs.

MIT © AKHBaig

来源:README.md,提交 afe11c3

工具

4

search_list

Autocomplete against an AutoSugges reference list (countries, NAICS, airports, currencies, ...). Returns the ranked, bounded suggestions for ONE query; it cannot enumerate a list. The publishable key (server env) decides which list is searched.

输入参数listlimitquery必填localeparent

list_datasets

Catalog of AutoSugges platform datasets: slug, name, description, category, availability, authority. Metadata only; never items.

无需输入参数。

get_dataset

Metadata for one platform dataset by slug, plus its docs URL. Never returns items; use search_list to query.

输入参数slug必填

get_integration_instructions

Self-contained, agent-ready instructions for integrating AutoSugges into a framework or using one runtime endpoint.

输入参数framework必填

版本历史

1
  1. v0.1.1最新Oct 26, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分