Servemyapi

🚀 サーブマイAPI

MCP（モデルコンテキストプロトコル）に基づく個人用サーバーで、macOSのキーチェーンを介してプロジェクト間でAPIキーを安全に保存し、アクセスします。

⚠️ 重要提示

ServeMyAPI は macOS 専用のツールで、現在は macOS システムのみをサポートしています。キーチェーンの内容はシステムによって保護されており、ユーザー認証が必要です。

🚀 クイックスタート

ServeMyAPI は、APIキーを安全に保存および管理するためのシンプルで強力なツールです。MCPプロトコルを統合することで、Claudeなどの言語モデルや他のAIツールが必要なキーを簡単に取得できるようになり、これらの機密情報が平文で保存または漏洩されることがなくなります。

📦 インストール

# リポジトリをクローンする
git clone [Your Repository URL]
cd servemyapi

# 依存関係をインストールする
npm install

# 開発モードで起動する（ホットリロード付き）
npm run dev

💻 使用例

基本的な使用法

プロジェクトの初期化

プロジェクトのルートディレクトリで package.json ファイルを作成し、編集して以下の内容を追加します。

{
  "name": "your-project-name",
  "version": "1.0.0",
  "scripts": {
    "serve": "node dist/index.js"
  },
  "dependencies": {
    "servemyapi": "file:."
  }
}

キーチェーンアクセスの設定

ターミナルで以下のコマンドを実行し、システムのキーチェーンに対する読み書き権限を持っていることを確認します。

security list-keychains -d

指示に従って管理者パスワードを入力します。

高度な使用法

機能概要

ServeMyAPI は以下の主要機能を提供します。

• キーの保存：store-api-key ツールを使用して、機密情報をシステムのキーチェーンに安全に保存します。
• キーの取得：get-api-key ツールを使用して、キーチェーンから特定のキーを取得し、APIリクエストやその他の認証が必要な操作に使用します。
• キーの削除：delete-api-key ツールを使用して、不要になったキーのエントリを削除します。
• すべてのキーの一覧表示：list-api-keys ツールを使用して、保存されているすべてのキーとその識別子を表示します。

操作例

キーの保存

node dist/index.js store --name "OpenAI API Key" --key "your-api-key-here"

キーの取得

node dist/index.js get --name "OpenAI API Key"

キーの削除

node dist/index.js delete --name "OpenAI API Key"

すべてのキーの一覧表示

node dist/index.js list

🔧 技術詳細

セキュリティに関する注意事項

• アクセス制御：キーチェーンの内容はシステムレベルで保護されており、現在ログインしているユーザーのみがアクセスできます。
• 暗号化保存：すべてのキーは暗号化形式で保存され、ファイルシステムに平文で保存されることはありません。
• 監査ログ：デフォルトでは操作ログは記録されません。必要に応じて監査機能を有効にすることをおすすめします。

開発ガイド

# 開発サーバーの起動
npm run dev

# CLIツールの使用
npm run cli list

# コードフォーマットのチェック
npm run lint

# 本番用バージョンのビルド
npm run build

🤝 貢献とサポート

問題、提案、または機能要求を歓迎します。セキュリティホールを発見した場合は、すぐに報告してください。

📄 ライセンス

MIT