agentos

AgentOS MCP Server

自然言語で安全な AI エージェントを構築し、ポリシー違反を 0％に

Agent OS の一部 - AI エージェントのカーネルレベルのガバナンス

🚀 クイックインストール

npx agentos-mcp-server

npm： agentos-mcp-server
MCP Registry： io.github.imran-siddique/agentos

概要

AgentOS MCP Server は、Claude Desktop、GitHub Copilot、Cursor など、あらゆる MCP 対応 AI アシスタントに Agent OS の安全性フレームワークを完全な形で提供します。自然な会話を通じて、ポリシーに準拠した自律型エージェントを作成、デプロイ、管理できます。

┌─────────────────────────────────────────────────────────────┐
│           Claude Desktop / Copilot / Cursor                  │
│  ┌────────────────────────────────────────────────────────┐ │
│  │            "Create an agent that..."                    │ │
│  └──────────────────────┬─────────────────────────────────┘ │
└─────────────────────────┼───────────────────────────────────┘
                          │ MCP Protocol
            ┌─────────────▼─────────────┐
            │   🛡️ AgentOS MCP Server   │
            │                           │
            │  • 10 Tools              │
            │  • Policy Engine         │
            │  • Approval Workflows    │
            │  • Audit Logging         │
            │  • Template Library      │
            └─────────────┬─────────────┘
                          │
      ┌───────────────────┼───────────────────┐
      │                   │                   │
┌─────▼─────┐      ┌──────▼──────┐     ┌─────▼─────┐
│  Agents   │      │  Policies   │     │  Audit    │
│  (Local)  │      │  (Enforced) │     │  (Logged) │
└───────────┘      └─────────────┘     └───────────┘

✨ 特長

🤖 自然言語によるエージェント作成

User: Create an agent that processes customer feedback from support emails daily

Claude: ✅ Agent Created Successfully!

Agent: customer-feedback-processor
✅ Data Source: Email inbox via IMAP
✅ Processing: Sentiment analysis + categorization
✅ Output: Daily summary to Slack
✅ Schedule: Every day at 9 AM

Safety Policies Applied:
🛡️ PII Protection: Customer emails/names anonymized
🛡️ Rate Limiting: Max 1000 emails per run
🛡️ Human Review: Negative sentiment cases flagged

🛡️ 違反率 0％のポリシー適用

• 組み込みポリシー 6 種（PII、レート制限、コスト管理、データ削除、シークレット、人間によるレビュー）
• リアルタイムのポリシー評価
• 違反を自動的にブロック
• 明確な説明と代替案

✅ 人間参加型の承認ワークフロー

• リスクに基づく承認要件
• 重要なアクションに対する複数関係者の承認
• メール／Slack 通知
• 有効期限の処理

📊 完全な監査証跡

• すべてのアクションを改変不可能な形で記録
• ポリシー評価を記録
• コンプライアンスレポートの生成
• 監査担当者向けのエクスポート

📋 テンプレートライブラリ

• 10 種以上のエージェントテンプレート（データ処理、メールアシスタント、バックアップ、スクレイパーなど）
• 6 種以上のポリシーテンプレート（GDPR、SOC 2、HIPAA、PCI DSS など）
• 業界固有のコンプライアンスフレームワーク

🏛️ コンプライアンス対応

• SOC 2 - セキュリティおよび可用性の管理策
• GDPR - EU のデータ保護
• HIPAA - 医療データのプライバシー
• PCI DSS - 決済カードのセキュリティ
• CCPA - カリフォルニア州のプライバシー
• NIST - サイバーセキュリティフレームワーク
• ISO 27001 - 情報セキュリティ
• FedRAMP - 連邦政府の認証

🚀 クイックスタート

ステップ 1：Claude Desktop を設定する

claude_desktop_config.json に追加します。

Windows： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agentos": {
      "command": "npx",
      "args": ["-y", "agentos-mcp-server"],
      "env": {
        "AGENTOS_POLICY_MODE": "strict"
      }
    }
  }
}

ステップ 2：Claude Desktop を再起動する

Claude Desktop を終了して再度開き、MCP サーバーを読み込みます。

ステップ 3：エージェントの構築を始めましょう！

Claude に自然な言葉で尋ねるだけです。

"Create an agent that backs up my Documents folder to Google Drive every night"

Claude は次のことを行います。

1. 適切な設定でエージェントを作成する
2. タスクに基づいて安全ポリシーを提案する
3. デプロイ前にテストできるようにする
4. モニタリングを有効にしてデプロイする

💬 会話の例

データ処理エージェントの作成

User: I need an agent that processes customer feedback from support emails daily

Claude: ✅ Agent Created Successfully!

Agent: customer-feedback-processor
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Status: draft
Language: python

Task:
Process customer feedback from support emails daily

Workflow Steps:
1. connect_email: email.connect
2. process_data: execute
3. output_results: output

Safety Policies Applied:
🛡️ PII Protection: Customer emails/names anonymized
🛡️ Rate Limiting: Max 1000 emails per run
🛡️ Human Review: Negative sentiment cases flagged

Next Steps:
1. Use `test_agent` to run a dry-run test
2. Use `attach_policy` to add more safety policies
3. Use `deploy_agent` when ready to run

デプロイ前のテスト

User: Test this agent with a scenario of processing 100 emails

Claude: ✅ Test PASSED

Agent: customer-feedback-processor
Scenario: Process 100 customer emails
Mode: Dry Run (no changes)

Configuration Check: ✅ Valid
Workflow Check: ✅ Valid (3 steps)

Policy Evaluation: ✅ No violations detected

Warnings:
⚠️  PII access logged

Resource Estimates:
- Duration: ~30 seconds
- Cost: $0.05

Next Step: Use `deploy_agent` to deploy this agent.

コンプライアンスの確認

User: Check if this agent is SOC 2 compliant

Claude: # Compliance Report: SOC2

Agent: customer-feedback-processor
Framework: SOC2
Date: 2026-01-30

## Summary
✅ COMPLIANT
Score: 100% (4/4 controls passed)

## Control Assessment

✅ CC6.1: Logical Access Controls
   Restrict logical access to information assets
   Evidence: Policy enforcement enabled, Access logging active

✅ CC6.6: Security Event Monitoring
   Detect and respond to security events
   Evidence: Audit logging enabled, Event timestamps recorded

✅ CC7.2: Incident Response
   Respond to security incidents
   Evidence: Human review enabled, Escalation procedures in place

✅ CC8.1: Change Management
   Manage changes to system components
   Evidence: Deployment approval required, Version control enabled

カスタムポリシーの作成

User: Create a policy that blocks access to customer credit card data

Claude: ✅ Custom Policy Created

Policy: Block Access To Customer
ID: custom-a1b2c3d4
Category: security

Description:
Block access to customer credit card data

Rules Generated (1):

🟠 custom_block_rule [high]
   Block actions based on: block access to customer credit card data
   Action: deny

Usage:
1. Attach to agent: `attach_policy` with policyId "custom-a1b2c3d4"
2. Test enforcement: `test_agent` with policy scenarios
3. View active policies: `get_agent_status`

🔧 利用可能なツール

ツール	説明
create_agent	自然言語の説明からエージェントを作成する
attach_policy	エージェントに安全ポリシーを適用する
test_agent	デプロイ前にドライランテストを行う
deploy_agent	エージェントをローカルまたはクラウドにデプロイする
get_agent_status	エージェントのステータスとメトリクスを取得する
list_templates	エージェントおよびポリシーテンプレートを参照する
request_approval	機密性の高いアクションの承認リクエストを作成する
audit_log	監査証跡を検索する
create_policy	説明からカスタムポリシーを作成する
check_compliance	コンプライアンスフレームワークに照らして確認する

ツールの詳細

create_agent

自然言語による説明と自動ポリシー推奨をもとに、新しい AI エージェントを作成します。

パラメーター：

Parameter	Type	Required	Description
description	string	✅	エージェントのタスクを自然言語で説明します
policies	string[]		適用するポリシーテンプレート
approvalRequired	boolean		実行前に人間による承認を必須にします
language	string		python、typescript、javascript、go
schedule	string		定期実行の Cron スケジュール

attach_policy

競合を検出しながら、エージェントに安全ポリシーを適用します。

パラメーター：

Parameter	Type	Required	Description
agentId	string	✅	ポリシーを適用するエージェント ID
policyId	string	✅	ポリシーテンプレート ID
customRules	object[]		追加のカスタムルール

test_agent

シミュレーションシナリオを使って、ドライランテストを実行します。

パラメーター：

Parameter	Type	Required	Description
agentId	string	✅	テストするエージェント ID
scenario	string	✅	テストシナリオの説明
mockData	object		テスト用のモックデータ
dryRun	boolean		副作用なしで実行します（デフォルト：true）

deploy_agent

エージェントをローカル環境またはクラウド環境にデプロイします。

パラメーター：

Parameter	Type	Required	Description
agentId	string	✅	デプロイするエージェント ID
environment	string		local または cloud
autoStart	boolean		デプロイ後すぐに起動します

check_compliance

規制フレームワークに照らして、エージェントを確認します。

パラメーター：

Parameter	Type	Required	Description
agentId	string	✅	確認するエージェント ID
framework	string	✅	SOC2、GDPR、HIPAA、PCI_DSS、CCPA、NIST、ISO27001、FEDRAMP
generateReport	boolean		詳細レポートを生成します

📋 ポリシーテンプレート

組み込みのセキュリティポリシー

Policy ID	Name	Description
pii-protection	PII Protection	個人を特定できる情報（GDPR）を保護します
rate-limiting	Rate Limiting	レート制限によってリソースの不正使用を防ぎます
cost-control	Cost Control	自動化によるコストの予期せぬ増大を防ぎます
data-deletion	Data Deletion Safety	誤ったデータ消失を防ぎます
secrets-protection	Secrets Protection	認証情報の漏えいを防ぎます
human-review	Human Review Required	機密性の高い操作に承認を必須とします

コンプライアンステンプレート

Template ID	Framework	Description
gdpr-compliance	GDPR	EU 一般データ保護規則
soc2-security	SOC 2	SOC 2 Type II セキュリティ管理策
hipaa-healthcare	HIPAA	医療データのプライバシー（PHI の保護）
pci-dss-payments	PCI DSS	決済カードデータのセキュリティ
read-only-access	Security	データベースを読み取り専用に制限します
production-safety	Operations	本番環境向けの追加の安全対策

🤖 エージェントテンプレート

データ処理

Template	Description	Default Policies
data-processor	データファイルを処理・変換します	rate-limiting, cost-control
web-scraper	データ収集のためにウェブサイトをスクレイピングします	rate-limiting, cost-control
report-generator	定期レポートを生成します	pii-protection, rate-limiting

コミュニケーション

Template	Description	Default Policies
email-assistant	メールを監視・処理します	pii-protection, human-review
slack-bot	Slack 通知を自動化します	human-review, rate-limiting

インフラストラクチャ

テンプレート	説明	デフォルトポリシー
backup-agent	ファイルをクラウドストレージにバックアップします	cost-control
api-monitor	API の健全性とパフォーマンスを監視します	rate-limiting
file-organizer	ルールに基づいてファイルを整理します	data-deletion

分析

テンプレート	説明	デフォルトポリシー
database-analyst	データベースをクエリし、レポートを生成します	data-deletion, pii-protection
content-moderator	ユーザー生成コンテンツをモデレートします	human-review, pii-protection

⚙️ 設定

環境変数

変数	説明	デフォルト
AGENTOS_API_KEY	クラウド機能用の API キー	(none)
AGENTOS_POLICY_MODE	strict または permissive	strict
AGENTOS_DATA_DIR	ローカルデータディレクトリ	.agentos
AGENTOS_LOG_LEVEL	debug、info、warn、error	info

ポリシーモード

モード	動作
strict	ポリシー違反があると、すべてのアクションがブロックされます
permissive	重大な違反のみがブロックされます（警告はログに記録されます）

データストレージ

すべてのデータは、ローカルの AGENTOS_DATA_DIR に保存されます。

.agentos/
├── agents/           # Agent configurations
│   └── {id}.json
├── approvals/        # Approval requests
│   └── {id}.json
└── audit/            # Audit logs (JSONL format)
    └── {date}.jsonl

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                     Claude Desktop                           │
│  ┌────────────────────────────────────────────────────────┐ │
│  │                    Claude AI Model                      │ │
│  │     Natural language understanding & orchestration      │ │
│  └──────────────────────┬─────────────────────────────────┘ │
│                         │ MCP Protocol                       │
│  ┌──────────────────────▼─────────────────────────────────┐ │
│  │                    MCP Client                           │ │
│  │          Tool discovery & request handling              │ │
│  └──────────────────────┬─────────────────────────────────┘ │
└─────────────────────────┼───────────────────────────────────┘
                          │ stdio
┌─────────────────────────▼───────────────────────────────────┐
│               @agentos/mcp-server (Node.js)                 │
│  ┌────────────────────────────────────────────────────────┐ │
│  │                    MCP Server                           │ │
│  │            Tool/Resource/Prompt handlers                │ │
│  └────────────────────────────────────────────────────────┘ │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────┐  │
│  │  Agent   │ │  Policy  │ │ Approval │ │    Audit      │  │
│  │ Manager  │ │  Engine  │ │ Workflow │ │   Logger      │  │
│  └──────────┘ └──────────┘ └──────────┘ └───────────────┘  │
│  ┌────────────────────────────────────────────────────────┐ │
│  │              Template Library (50+ templates)           │ │
│  └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                          │ HTTPS (optional)
┌─────────────────────────▼───────────────────────────────────┐
│              AgentOS Cloud Platform (Future)                │
│     • Persistent storage  • Multi-tenant  • Enterprise      │
└─────────────────────────────────────────────────────────────┘

🔒 セキュリティ

機能	説明
ポリシーの適用	実行前に、すべてのアクションをポリシーに照らして検証します
データのマスキング	ログ内の機密データを自動的にマスキングします
シークレットの保護	シークレットはプレーンテキストで保存されません
監査証跡	コンプライアンスに対応した、完全かつ改ざん不可能なログ
人による承認	高リスクの操作には承認が必要です
ローカル優先	デフォルトですべてのデータをローカルに保存します

💻 開発

ローカル開発

# Clone the repository
git clone https://github.com/imran-siddique/agent-os
cd agent-os/packages/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in stdio mode (for Claude Desktop)
npm start -- --stdio

# Run in HTTP mode (for development)
npm start -- --http --port 3000

プロジェクト構成

packages/mcp-server/
├── src/
│   ├── index.ts              # Main entry point
│   ├── cli.ts                # CLI with --stdio/--http modes
│   ├── server.ts             # MCP server implementation
│   ├── tools/                # 10 MCP tools
│   │   ├── create-agent.ts
│   │   ├── attach-policy.ts
│   │   ├── test-agent.ts
│   │   ├── deploy-agent.ts
│   │   ├── get-agent-status.ts
│   │   ├── list-templates.ts
│   │   ├── request-approval.ts
│   │   ├── audit-log.ts
│   │   ├── create-policy.ts
│   │   └── check-compliance.ts
│   ├── services/             # Core business logic
│   │   ├── agent-manager.ts
│   │   ├── policy-engine.ts
│   │   ├── approval-workflow.ts
│   │   ├── audit-logger.ts
│   │   └── template-library.ts
│   ├── prompts/              # MCP prompts
│   └── types/                # TypeScript definitions
├── package.json
├── tsconfig.json
└── README.md

テストの実行

npm test
npm run test:coverage

📊 パフォーマンス

指標	目標
MCP サーバーの起動	<2 秒
ツールの応答時間	<500ms（p95）
メモリ使用量	<100MB
ポリシー評価	<50ms

📜 ライセンス

MIT ライセンス — 詳細は LICENSE を参照してください。

---