Candor UI MCPサーバー
コミット 2026年11月14日Provides documentation and component suggestions for building honest agent user interfaces with shadcn/ui.
別名 MethodicDev/candor, candor
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 6.2.0
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
Candor UI MCPとは
Candor UIはMCPサーバーです。 Provides documentation and component suggestions for building honest agent user interfaces with shadcn/ui.
プロジェクトのREADMEから生成された概要
Candor UI MCP server について
Candor UI provides a specialized set of interface components and documentation designed to build honest user interfaces for AI agents. It is built for developers using shadcn/ui and offers components like chat threads, tool calls, reasoning displays, and permission prompts. These elements are engineered to follow specific honesty rules, such as ensuring decision buttons like allow and deny start with neither option pre-selected and ensuring that unknown data is marked as not measured rather than zero.
Developers can integrate these tools into projects via the candor-ui CLI or by installing the @candor-ui/react package from npm. The server functions as a read-only MCP tool that provides documentation and component suggestions without requiring an API key or paid account. It is compatible with various frameworks and includes adapters for the Vercel AI SDK, the Claude Agent SDK, and AG-UI. The system also includes a suite of CLI tools for linting, auditing, and verifying that your UI adheres to established honesty principles.
できること
- 1Suggest honest UI componentsAn AI agent can use this server to find the right component for a specific task while following honesty rules.
- 2Audit interface honestyA developer can run a command to check if their running application follows the required design principles.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Candor UI MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにCandor UI MCPをインストール
$ claude mcp add --transport http candor https://candor.themethodic.com/mcpCursorにCandor UI MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"candor": {
"url": "https://candor.themethodic.com/mcp"
}
}
}VS CodeにCandor UI MCPをインストール
.vscode/mcp.json
{
"servers": {
"candor": {
"type": "http",
"url": "https://candor.themethodic.com/mcp"
}
}
}VS Code CLIにCandor UI MCPをインストール
$ code --add-mcp '{"name":"candor","type":"http","url":"https://candor.themethodic.com/mcp"}'CodexにCandor UI MCPをインストール
$ codex mcp add candor --url https://candor.themethodic.com/mcpCodex config.tomlにCandor UI MCPをインストール
~/.codex/config.toml
[mcp_servers.candor] url = "https://candor.themethodic.com/mcp"
Gemini CLIにCandor UI MCPをインストール
$ gemini mcp add -s user --transport http candor https://candor.themethodic.com/mcpGemini settings.jsonにCandor UI MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"candor": {
"url": "https://candor.themethodic.com/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能methodicdev/candor is public and reachablegithub.com/methodicdev/candor ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-14github.com/methodicdev/candor ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 124 ms合格
README
GitHubで見るCandor UI: the free tier
Honest agent UI for shadcn/ui: chat, tool calls and permission prompts that never overstate what an agent did. MIT.

Try the app demo · Honest against typical, side by side · Docs · Changelog
Interface components for agent apps: a thread, messages, a composer, tool calls, reasoning and citations, the
building blocks under them, a light, dark and high-contrast theme, and adapters for the Vercel AI SDK, the Claude
Agent SDK and AG-UI. For shadcn/ui projects, installed with the candor-ui CLI or shadcn's own, MIT licensed.
This repo is the source of Candor UI's 73 free items (version 4.0.2), the skill and plugins for coding agents and 3 starter apps. Docs and live examples: https://candor.themethodic.com.
The same free items are on npm as @candor-ui/react, for people who
would rather npm install than copy code in. That package changes only when a free item changes, so its version can be
behind the kit's after a release that changed only Pro items; the CLI, candor-ui, has a version of its own. The
changelog says which release changed what.
Try it in a minute, no key
npx degit MethodicDev/candor/starter-vite-ag-ui my-app
cd my-app
npm install
npm run dev
Open the address it prints. A scripted agent answers in the page: fixed replies, no model, no server and no API key,
and the page says so. Ask it to add "Try a Candor block" to your list and you'll see a line of its reasoning, a tool
call marked "Needs you", and a permission prompt that shows what it will run, with Deny and Allow and neither
chosen for you. That is what the image above shows. Point VITE_AGENT_URL at an AG-UI agent (LangGraph, CrewAI…)
when you want a real one.
Why Candor
An agent that acts on real systems can mislead without saying anything false: a spinner nobody has heard from, a total that treats a missing cost as zero, an approval that now applies to a different change. Candor's components keep these 9 rules. Where Honest against typical has a moment that shows one, the link goes to its Typical and Honest switch; the others go to Principles.
- Model output is text, never markup: Adapters read what a model writes as a small safe subset of markdown; a link becomes plain text with its address beside it.
- Unknown stays unknown: A cost or duration the service didn't report reads “not measured”, not zero, and an estimate says it is one.
- A control that can't be used says why: A control that can't be used carries its reason, on hover and focus and to screen readers.
- Nothing is pre-selected in a decision: Approve and reject, allow and deny start with neither chosen.
- Approve the exact change: A decision is tied to a hash of the change that was asked about; a change that moved since is refused.
- Reasoning is believed, not verified: Reasoning is shown as the model's own account and marked as unchecked; evidence is shown as evidence.
- The agent is always named, by the app: Every agent message names its agent from the app's data, never from model output.
- Say what can and can't be undone: Destructive actions say what they remove and whether it can be brought back.
- Motion follows the outcome: A success mark is drawn after the result settles; motion reports a change and never predicts one.
Install
npx candor-ui@latest init
npx candor-ui add thread message composer
candor-ui init adds the @candor registry to components.json and the theme to your CSS; in a project without
shadcn yet it runs shadcn's setup first (--yes sets it up with Base UI and shadcn's nova preset, no questions). Or add the registry by
hand: "@candor": "https://candor.themethodic.com/r/{name}.json". If shadcn asks to overwrite a primitive such as
ui/button.tsx, answer yes: Candor's button styles locked actions; without a terminal, pass --overwrite.
Or from npm
npm install @candor-ui/react
import { Thread, Message, Composer } from "@candor-ui/react"
Then @import "@candor-ui/react/styles.css" after Tailwind. The package holds the free tier only, and its version can be
behind the kit's; its README has the adapters and the entry points.
Tools
candor-ui also checks what you build, from the CLI's own docs:
lintchecks your.tsx,.ts,.jsxand.jsfiles against Candor's honesty rules and printspath:line:col rule messagefor each finding; it exits 1 on an error.auditislintplus a look at a running page:npx candor-ui audit http://localhost:3000runs axe and the honesty rules on it and writesAUDIT.md.updatemoves installed items to the latest version and keeps your changes: a file you edited gets a three-way merge, and where you and we changed the same lines it writes conflict markers.verifyis for CI: it checkscandor-lock.jsonagainst the registry's versioned snapshots and the files on disk.theme checkchecks your theme's colour contrast and its motion and sound values, and changes nothing.
candor-ui doctor explains an install that looks wrong. Every command is in the
CLI's README.
For coding agents
llms-install.md tells an agent how to set Candor up in a project by itself: the CLI, the docs MCP server, the skill
and the honesty rules to keep. The skill alone:
npx skills add MethodicDev/candor
installs two skills: skills/candor-ui (which component fits which job, the adapters, and the rules the components
keep, with a design-system reference read from the shipped CSS) and skills/candor-agent-ui (design fundamentals for
screens where an AI agent acts, with a review checklist to run after each screen; it works with or without Candor).
The plugins install the skill and the docs MCP server together. Claude Code: claude plugin marketplace add MethodicDev/candor, then claude plugin install candor-ui@candor (or, in a session,
/plugin install candor-ui --marketplace MethodicDev/candor). GitHub Copilot CLI: copilot plugin marketplace add MethodicDev/candor, then copilot plugin install candor-ui@candor. VS Code installs candor-ui from this repo's URL;
Cursor reads .cursor-plugin/marketplace.json; the Codex package is plugins/codex/candor-ui.
The MCP server at https://candor.themethodic.com/mcp serves docs and component suggestions only: read-only, no key,
never paid source. .mcp/server.json describes it for the MCP registry. Agents can also read
https://candor.themethodic.com/llms.txt.
Starters
Starter apps with a working agent chat built from these components (3 of them). Each installs and builds on its own:
| Folder | Stack | Agent |
|---|---|---|
starter-vite-ag-ui/ |
Vite and React, no server | a scripted one in the page (no key; see above), or any AG-UI agent (LangGraph, CrewAI…) |
starter/ |
Next.js 16 | Vercel AI SDK at /, Claude Agent SDK at /claude (needs an Anthropic API key) |
starter-tanstack-start-claude/ |
TanStack Start | Claude Agent SDK (needs an Anthropic API key) |
npx degit MethodicDev/candor/starter-vite-ag-ui my-agent-app
npx degit MethodicDev/candor/starter my-agent-app
npx degit MethodicDev/candor/starter-tanstack-start-claude my-agent-app
What's here
73 free items, each with a docs page that has its props and live examples. Install any of them by name:
npx candor-ui add <name>.
| Area | What it's for | Items |
|---|---|---|
| Chat (20) | A conversation with an agent: messages, the composer, tool calls, reasoning, citations. | agent-avatar, ai-disclosure, attachment-preview, card-registry, citation, composer, context-meter, entity-chip, folded-turns, message-actions, message-content, message, payload, permission-prompt, prompt-suggestions, reasoning, thread-divider, thread-event, thread, tool-call |
| Adapters (7) | Map an agent SDK's messages onto Candor's data: the Vercel AI SDK, the Claude Agent SDK and AG-UI. | ag-ui, ai-sdk, claude-agent-sdk, claude-agent-server, use-ag-ui, use-candor-chat, use-claude-agent |
| Building blocks (7) | Small pieces every screen uses: locked controls, status dots, step lists, relative times. | copy-field, degraded-panel, relative-time, status-dot, step-list, streaming-text, surface |
| App shell (2) | The app around the agent: layout, sidebar, command menu, sessions, notices. | page-header, page-state |
| Primitives (13) | The shadcn/ui primitives Candor's components are built on. | accordion, alert, button, checkbox, collapsible, label, locked, popover, progress, skeleton, slider, switch, tooltip |
| Themes (6) | The default theme and 5 gallery themes: colours, type, radius and motion as CSS variables, in light, dark and high contrast. | tokens, theme, theme-slate, theme-paper, theme-console, theme-signal |
Shared types and helpers (15): Types and pure functions the components share.
chat, fill-strings, format-elapsed, highlight, know, layer, locale, mcp-input, motion, safe-markdown, sound, status, use-copy, use-shortcut, use-virtual-list
Fonts (3): Self-hosted, and optional: without one the theme uses the system font.
font-inter, font-source-sans, font-ibm-plex
Pro, Premium and Team
One-time prices, no subscription. A licence includes every version Candor UI publishes, major ones included. You can ask for a full refund within 30 days of buying. The free tier here is MIT.
| Tier | Price | What's in it | Support |
|---|---|---|---|
| Free (this repo) | $0, MIT | 73 items: the chat core, building blocks, themes, adapters; 3 starters; the skill and plugins | public issues here |
| Pro | $149, one person | All 293 items, the free ones included: the app shell, plans, approvals, diffs, runs, evals and admin | none; the docs and examples |
| Premium | $249, one person | Pro, plus 11 full-stack blocks and 4 templates, each for the Vercel AI SDK and the Claude Agent SDK | email, best effort |
| Team | $999, up to 10 people in one company | Premium | email, a first reply within 2 business days |
Buy at https://candor.themethodic.com/#pricing. The terms are the Candor UI Commercial Licence; SUPPORT.md repeats the support each tier includes. Your key arrives in Polar's receipt email and customer portal; https://candor.themethodic.com/licence-key says where, and what a refund does to it. Then, in your project:
npx candor-ui key <your licence key> # saves it to .env.local, checks it, and has the registry send it
npx candor-ui add approval-request # a Pro item, installed like any other
In CI, set CANDOR_LICENSE_KEY as a secret, so installs and npx candor-ui verify can read paid items. Installed code
needs no key to run; the key is only for installing and updating. Never put a key in an issue, a pull request or a
repository.
How this repository works
- The source of truth is private. Candor UI's main repository holds the free items and the paid tiers together. This repository is generated from it on each release, so a change made here by hand would be overwritten.
- From 2.6.2, each release is a commit, a tag and a GitHub Release. The commit
Candor X.Y.Z, the tagvX.Y.Zand the release all carry that version's changelog section. - Issues are read. Use the forms. There is no promised reply time for the free tier; the support each paid tier includes is in SUPPORT.md. A vulnerability goes to SECURITY.md, not to an issue.
- A pull request isn't merged here. If it is accepted, it is applied upstream by hand, credited in that release's changelog entry, and closed with a link to the release that holds it. CONTRIBUTING.md has the rest.
- Every release is reviewed over its full diff by a separate review session that had no part in writing it, before the owner approves the merge. Most of the code is written with AI coding assistants, and the commits here say so in a Co-Authored-By line.
Licence
MIT, © Methodic LLC. See LICENSE. It covers this repository's free items; Candor UI's paid items are under the
Candor UI Commercial Licence.
Candor UI MCPのよくある質問
Candor UI MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http candor https://candor.themethodic.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Candor UI MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
What does the Candor UI MCP server provide?
The MCP server serves documentation and component suggestions for the Candor UI library.
Can I use Candor UI with my existing shadcn/ui project?
Yes, you can install Candor UI components into shadcn/ui projects using the candor-ui CLI.