永続的なスレッドを持つチャット中心のアプリで、AIエージェントが共有アクションを実行し、ユーザーとチャットできるようにします。
別名 BuilderIO/agent-native, agent-native-chat
- スター
- 7,707
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.0
- 最終コミット
- 2026年11月15日
- ライセンス
- MIT
Agent-Native Chat MCPとは
永続的なスレッドを持つチャット中心のアプリで、AIエージェントが共有アクションを実行し、ユーザーとチャットできるようにします。
プロジェクトのREADMEから生成された概要
Agent-Native Chat MCP server について
このオープンソースのTypeScriptフレームワークを使用すると、自律的な作業と専用のインターフェースを組み合わせたエージェントを構築できます。開発者は、AIエージェントのツールとして機能すると同時に、ユーザーインターフェース内で呼び出し可能なコードとしても機能する「共有アクション」として機能を定義できます。これにより、エージェントが行ったすべての作業がユーザーに可視化され、UIで行われた手動の変更が共有データレイヤーを通じてエージェントに即座に反映されます。
開発者は、PGliteを使用してローカルで実装するか、PostgreSQLバックエンドを使用して本番環境にデプロイできます。このフレームワークには、エージェントに再利用可能な専門知識を与えるための、認証、権限管理、永続メモリの機能が含まれています。また、エージェントチームもサポートしており、ワークスペースを越えてスペシャリストが連携することが可能です。UI、HTTP、MCP、CLIに同じアクションレイヤーを使用することで、システムはすべてのアプリケーションロジックと状態の単一の信頼できる情報源(single source of truth)を維持します。
できること
- 1共有アプリケーション状態の維持ユーザーがインターフェース上で現在閲覧している特定のページやレコードを、エージェントが確実に理解できるようにします。
- 2繰り返しのエージェントタスクの自動化設定されたスケジュールや特定のトリガーに基づいて、エージェントが特定の業務を実行するワークフローを構築します。
- 3視覚的なアプリケーション編集の実行チャットインターフェースを使用して、キャンバス上で実行中のアプリケーションに対して特定のデザイン変更をリクエストします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Agent-Native Chat MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにAgent-Native Chat MCPをインストール
$ claude mcp add --transport http agent-native-chat https://starter.agent-native.com/mcpCursorにAgent-Native Chat MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"agent-native-chat": {
"url": "https://starter.agent-native.com/mcp"
}
}
}VS CodeにAgent-Native Chat MCPをインストール
.vscode/mcp.json
{
"servers": {
"agent-native-chat": {
"type": "http",
"url": "https://starter.agent-native.com/mcp"
}
}
}VS Code CLIにAgent-Native Chat MCPをインストール
$ code --add-mcp '{"name":"agent-native-chat","type":"http","url":"https://starter.agent-native.com/mcp"}'CodexにAgent-Native Chat MCPをインストール
$ codex mcp add agent-native-chat --url https://starter.agent-native.com/mcpCodex config.tomlにAgent-Native Chat MCPをインストール
~/.codex/config.toml
[mcp_servers.agent-native-chat] url = "https://starter.agent-native.com/mcp"
Gemini CLIにAgent-Native Chat MCPをインストール
$ gemini mcp add -s user --transport http agent-native-chat https://starter.agent-native.com/mcpGemini settings.jsonにAgent-Native Chat MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"agent-native-chat": {
"url": "https://starter.agent-native.com/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない未チェック
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
README
GitHubで見るAgent-Native
Agent-Native is an open-source TypeScript framework for building agents that pair autonomous work with a purpose-built UI. Define each capability once as an action: the agent uses it as a tool, and the UI calls it from code.
Quick start
npx --yes @agent-native/core@latest create my-agent --standalone --template chat
Follow the getting started guide for a full intro to the framework.
Why build agents with UIs?
Coding agents work with more than a text box. Their environment provides context, tools, files, tests, and previews that make their capabilities and results visible.
Knowledge work needs that same kind of environment. A UI shows what an agent can do and gives people familiar ways to inspect, edit, approve, and share its work.
How Agent-Native works
- Shared actions. The agent calls each capability as a tool, and the UI calls it from code. Both paths use the same validation, permissions, and implementation.
- Shared data. Work done by the agent appears in the UI, and work done in the UI is available to the agent.
- Shared application state. The agent receives relevant UI state, such as the current page, selected record, or active view.
The agent does not click through the UI. It works through the same action layer as the UI.
Example: a shared action
Create actions/hello.ts:
import { defineAction } from "@agent-native/core/action";
import { z } from "zod";
// One action powers every app surface: UI, agent, HTTP, MCP, A2A, and CLI.
export default defineAction({
description: "Return a friendly greeting.",
schema: z.object({
name: z.string().default("world").describe("Name to greet"),
}),
http: { method: "GET" },
run: async ({ name }) => {
return { message: `Hello, ${name}!` };
},
});
The agent receives hello as a tool. React calls the same function with useActionQuery("hello", { name: "Alex" }). Agent-Native also exposes it through HTTP, MCP, A2A, and the CLI.
Included
- Agent chat: Let people delegate work, ask questions, and review results in the same UI.
- Authentication and permissions: Control who can access and change shared work.
- Skills and memory: Give agents reusable expertise and persistent context.
- Automations: Run agent work on schedules or events.
- Agent teams: Delegate work to specialist agents in the same workspace or across connected agents.
- PostgreSQL backend: Use PostgreSQL in production and PGlite for local development on any Nitro-compatible host.
Example: edit a running app visually
Use /visual-edit in Claude Code to edit a running app on a canvas instead of
prompting for each small UI nudge. Compare live pages together, then ask Claude
to apply the chosen edits to your source. For example:
/visual-edit the onboarding flow, plus home at every breakpoint
Review the onboarding screens alongside Home at desktop, tablet, and mobile sizes, adjust a button's color or spacing directly, then ask Claude to apply the pending edits to your source. See the Visual Edit guide for the full walkthrough and sharing details.
Bring your LLM, SQL database, tools, and infrastructure. Everything you build stays yours.
See Agent-Native in action:
https://github.com/user-attachments/assets/ef51644b-6506-46d8-8083-0af7b7e5b65c
Open-source agents
Start from one of these agents or use it as an example for your own. For a source-to-answer architecture example, see Brain’s visual overview.
Clips
Record and understand meetings, screens, and voice notes.
Design
Generate and refine interactive designs.
Slides
Create and edit on-brand presentations.
Analytics
Ask questions of your data and build dashboards.
Calendar
Find time, schedule events, and manage bookings.
Prioritize email, draft replies, and follow up.
Assets
Create and organize on-brand media.
Content
Draft, organize, and publish content.
Plans
Create and review visual plans with diagrams, wireframes, and prototypes.
Explore the full app gallery, or start with the framework guide.
Documentation and community
- Read the documentation.
- Join Discord to ask questions, share what you're building, and get help.
Contributing
Want to send a change back? Start with CONTRIBUTING.md. DEVELOPMENT.md covers local setup, workspace structure, and guard scripts.
License
MIT
Agent-Native Chat MCPのよくある質問
Agent-Native Chat MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http agent-native-chat https://starter.agent-native.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Agent-Native Chat MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Agent-Nativeなチャットアプリを作成するにはどうすればよいですか?
chatテンプレートを使用してcreateコマンドを実行すると、スタンドアロンのプロジェクトの雛形が作成されます。
エージェントとUIの両方でアクションを機能させる仕組みを教えてください。
defineActionでアクションを一度定義するだけで、エージェントはそれをツールとして受け取り、Reactは同じ関数を呼び出すことができます。
Agent-Nativeではどのデータベースを使用しますか?
本番環境ではPostgreSQLを使用し、ローカル開発ではPGliteを使用します。