cli

@noticed/cli

面向 noticed 的 CLI、stdio 兼容桥接工具和 Claude Code 插件——搜索你的社交网络、管理关系，并通过 HTTP 或仅支持 stdio 的客户端使用官方 noticed MCP。

npm install -g @noticed/cli
noticed search "AI engineers"
noticed path @sarahml

---

添加到你的 AI 编码 Agent

官方 MCP 将所有经过审核的 noticed 功能作为直接的类型化工具提供：关系搜索和档案、任务和目标、人员和互动、列表和视图、记忆、定时任务等。托管服务负责管理工具注册表和架构，因此所有客户端看到的都是相同且最新的功能集。

正从 0.3.x 升级？请使用 @noticed/[email protected] 或更新版本重新启动。已停用的 search / execute 元工具现已替换为 https://mcp.noticed.so/api/mcp 返回的官方直接工具。

你有两种连接方式：托管（无需安装，使用 Streamable HTTP）或 stdio（通过 npx 使用此软件包）。两者都连接到同一服务，并提供相同的直接工具。仅当你的 MCP 客户端不支持 Streamable HTTP 时，才使用 stdio。

托管 MCP 服务（推荐——无需安装）

https://mcp.noticed.so/api/mcp 是一个托管的 Streamable HTTP 端点。支持两种身份验证方式；请选择客户端偏好的方式。

OAuth（claude.ai 网页版、ChatGPT MCP，以及任何支持 OAuth 发现的客户端）

托管服务是一个符合规范的 OAuth 2.1 授权服务，支持动态客户端注册。遵循 MCP 授权规范 的客户端——包括 claude.ai 的自定义连接器和 ChatGPT 的 MCP 集成——会自动发现服务、注册自身，并引导用户完成授权页面。客户端配置中无需 API 密钥。

claude.ai 自定义连接器：打开 Settings → Connectors → Add custom connector，将 https://mcp.noticed.so/api/mcp 粘贴为 URL。其余步骤由 claude.ai 自动完成。已连接的应用可在 noticed.so/dashboard/oauth-grants 中查看（并撤销授权）。

API 密钥 Bearer（Claude Code、Cursor，以及任何支持自定义标头的客户端）

对于可以设置 Authorization: Bearer … 标头的客户端，请在 noticed.so/dashboard/api-keys 创建密钥并直接使用——无需 OAuth 流程。

Claude Code（一条命令）：

claude mcp add --transport http --scope user noticed https://mcp.noticed.so/api/mcp --header "Authorization: Bearer nk_live_…"

Cursor、Claude Desktop、Zed、VS Code Copilot、Windsurf、Cline——均支持 URL + 标头配置。删除下方任意 stdio 配置片段中的 command/args/env 块，并替换为：

{
  "mcpServers": {
    "noticed": {
      "url": "https://mcp.noticed.so/api/mcp",
      "headers": { "Authorization": "Bearer nk_live_…" }
    }
  }
}

Stdio 桥接工具（此软件包）

noticed mcp 命令会将 stdio 安全地代理到官方托管 MCP。请在下方选择你的客户端进行 stdio 安装。

Claude Code

claude mcp add --scope project noticed -- npx -y @noticed/cli mcp

--scope project 会将配置写入仓库根目录下的 .mcp.json，让整个团队共享该服务。个人范围安装时可省略此标志。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": {
        "NOTICED_API_KEY": "nk_live_…"
      }
    }
  }
}

Cursor

编辑 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

VS Code（Copilot Chat、GitHub Copilot Agent 模式）

编辑 .vscode/mcp.json 以配置工作区，或运行 MCP: Open User Configuration 进行全局配置：

{
  "servers": {
    "noticed": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

请注意，VS Code 使用 servers（而非 mcpServers），并且要求设置 type。

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

Cline (VS Code)

编辑 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

Continue

MCP 仅在 Agent 模式下可用。添加 .continue/mcpServers/noticed.yaml：

mcpServers:
  - name: noticed
    command: npx
    args: ["-y", "@noticed/cli", "mcp"]
    env:
      NOTICED_API_KEY: nk_live_…

Zed

编辑 ~/.config/zed/settings.json（注意：键名是 context_servers，不是 mcpServers）：

{
  "context_servers": {
    "noticed": {
      "command": "npx",
      "args": ["-y", "@noticed/cli", "mcp"],
      "env": { "NOTICED_API_KEY": "nk_live_…" }
    }
  }
}

---

Agent 技能和插件

可移植的 noticed Agent 技能适用于 Codex、Claude Code、Cursor，以及由开放的 skills 生态系统支持的其他客户端：

# Inspect the skill before installation
npx skills add noticedso/cli --list

# Install globally for Codex and Claude Code
npx skills add noticedso/cli --skill noticed-search -g \
  --agent codex --agent claude-code -y

该仓库也是一个 Agent Plugins 1.0 软件包。它包含可移植的 plugin.json、skills/ 和 mcp.json，以及 .claude-plugin/ 下的 Claude Code 兼容性清单。MCP 定义会启动版本固定的 stdio 桥接程序；请在客户端环境中配置 NOTICED_API_KEY，或在查询生产数据前运行 noticed config --set-key …。

要直接从源代码安装 Claude Code 兼容插件：

git clone https://github.com/noticedso/cli ~/.claude/plugins/noticed
# restart Claude Code

---

快速入门（CLI）

# 1. Mint an API key at https://www.noticed.so/dashboard/api-keys
# 2. Configure credentials
noticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. Search your network
noticed search "react developers"

# 4. Find the shortest path to a specific person
noticed path @sarahml
noticed path --li sarah-chen

# 5. JSON output for scripting
noticed search "frontend" --json | jq '.hits[].github_login'

---

身份验证

CLI 使用 Bearer API 密钥进行身份验证。前往 /dashboard/api-keys 创建密钥——密钥仅在创建时显示一次，请立即复制。令牌格式为 nk_live_…，每个密钥每分钟限流 60 个请求，并可在同一页面撤销。

---

CLI 命令

noticed search <query>

在你的开发者网络中搜索人员、公司、技能或主题。

noticed search "AI engineers"                  # natural language
noticed search "@sarahml"                      # GitHub username
noticed search "CTO at Vercel"                 # job title + company
noticed search "kubernetes" --source github    # filter by source
noticed search "react" --limit 10 --json       # paginated JSON output
noticed search "engineers" --csv > out.csv     # CSV export
noticed search "Sarah Chen" --paths            # also fetch paths to top hits

标志	说明	默认值
-l, --limit <n>	最大结果数	25
-o, --offset <n>	分页偏移量	0
-s, --source <src>	筛选条件：github 或 linkedin	全部
--sort <col:dir>	排序：name:asc、company:desc	无
-p, --paths	获取与排名前 5 个结果之间的最短路径	关闭
-j, --json	输出原始 JSON	关闭
--csv	输出为 CSV	关闭
--no-color	禁用颜色	自动

noticed path [target]

查找你与某人之间的最短连接路径。

noticed path @sarahml             # by GitHub login
noticed path 12345                # by github_user_id
noticed path --li sarah-chen      # by LinkedIn username
noticed path @sarahml --json      # machine-readable

路径查询前会先通过搜索解析登录名。传入 --li 可跳过搜索步骤，直接通过 LinkedIn 用户名查询。

noticed config

noticed config                     # show current config
noticed config --set-url <url>     # set API URL
noticed config --set-key <key>     # set API key
noticed config --show              # show current config

配置存储在 ~/.config/noticed/config.json（符合 XDG 规范）。

noticed mcp

noticed mcp                        # bridge stdio to the canonical hosted MCP
noticed mcp --log-level debug      # include proxy debug logging on stderr

noticed completion <shell>

noticed completion bash >> ~/.bashrc
noticed completion zsh >> ~/.zshrc
noticed completion fish > ~/.config/fish/completions/noticed.fish

---

环境变量

变量	说明	必需
NOTICED_API_KEY	在 https://www.noticed.so/dashboard/api-keys 创建的 API 密钥	是
NOTICED_MCP_URL	覆盖 Streamable HTTP MCP 端点。默认值为 https://mcp.noticed.so/api/mcp	否
NOTICED_API_URL	覆盖 noticed 实例 URL。默认值为 https://www.noticed.so——仅在自托管时设置	否
NOTICED_BASE_URL	NOTICED_API_URL 的别名	否

优先级：CLI 标志 > 环境变量 > 配置文件。

---

MCP 工具

托管服务是当前直接工具接口的权威来源。客户端通过标准的 tools/list 请求发现 search_people、get_person、network_summary、任务和目标操作、列表和视图、记忆、互动及日程等常规工具。stdio 桥接程序会转发发现和调用，不会维护第二个注册表。

使用 MCP Inspector 测试：

# stdio bridge to the same hosted server
npx @modelcontextprotocol/inspector npx @noticed/cli mcp

# hosted (Streamable HTTP) — set Authorization: Bearer <key> in the inspector UI
npx @modelcontextprotocol/inspector
# URL: https://mcp.noticed.so/api/mcp

或者手动通过 stdio 桥接程序测试：

echo '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | noticed mcp
echo '{"jsonrpc":"2.0","method":"tools/list","id":2}' | noticed mcp

---

编程使用

import { NoticedApiClient } from "@noticed/cli";

const client = new NoticedApiClient({
  baseUrl: "https://www.noticed.so",
  apiKey: "nk_live_…",
});

const results = await client.search("AI engineers", { limit: 10 });
const path = await client.path({ to: results.hits[0]?.github_user_id });

console.log(results.hits, path);

---

开发

npm install
npm run build
npm test
npm run lint
npm run check-types

---

自托管 noticed

CLI 默认使用托管的 noticed 实例 https://www.noticed.so。可以自托管 noticed 本身，但运维负担较重；大多数用户应使用托管服务。

如果你运行自己的实例，请将 NOTICED_MCP_URL 设置为其 Streamable HTTP MCP 端点。对于标准部署，也可以设置 NOTICED_API_URL，CLI 会据此派生 /api/mcp：

export NOTICED_API_URL=https://noticed.your-domain.com
export NOTICED_API_KEY=nk_live_…
noticed search "AI engineers"
noticed mcp

托管服务的源代码位于 https://github.com/noticedso/noticed。

---

License

MIT © noticed