Sarcasm MCP Server

皮肉 MCP サーバー

皮肉な名言を提供する Model Context Protocol（MCP）サーバーです。この MCP サーバーは AI エージェントと連携し、機知に富んだ皮肉な返答を提供します。

🚀 特徴

• 皮肉な名言をすべて取得：利用可能な皮肉な名言をすべて取得します
• ランダムな皮肉な名言を取得：お楽しみいただけるよう、ランダムな皮肉な名言を取得します
• MCP 連携：Model Context Protocol に対応したあらゆる環境とシームレスに連携します

📋 必要条件

• Node.js 18.0 以上
• npm または yarn パッケージマネージャー

🔧 インストール

# Clone the repository
git clone https://github.com/yourusername/sarcasm-mcp.git

# Navigate to the project directory
cd sarcasm-mcp

# Install dependencies
npm install

# Build the project
npm run build

🧰 開発

# Install dependencies
npm install

# Build the project
npm run build

vs code で MCP を実行する

• まだ存在しない場合は、ワークスペースに mcp.json を作成します

mkdir .vscode
touch .vscode/mcp.json

• mcp.json ファイルに次の設定を追加します

{
    "servers": {
        "sarcasm": {
            "type": "stdio",
            "command": "node",
            "args": [
                "PATH_TO_YOUR_BUILD_DIRECTORY/index.js"
            ]
        }
    }
}

🛠️ 使用方法

NPX 経由で MCP サーバーを実行する

• まだ存在しない場合は、ワークスペースに mcp.json を作成します

mkdir .vscode
touch .vscode/mcp.json

• mcp.json ファイルに次の設定を追加します

{
    "servers": {
        "sarcasm": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "mcp-sarcasm"
            ]
        }
    }
}

GitHub Copilot での使用

この MCP サーバーは、Model Context Protocol に対応した GitHub Copilot やその他の AI アシスタントと連携します。接続すると、次のツールを使用できます。

1. get-all-sarcastic-quotes：利用可能な皮肉な名言をすべて取得します
2. get-random-sarcastic-quote：ランダムな皮肉な名言を取得します

例：

Can you #get-random-sarcastic-quote for me?

📦 パッケージ構成

sarcasm-mcp/
├── src/
│ ├── index.ts # Main server file
│ ├── constants/ # API constants
│ ├── service/ # Service for fetching quotes
│ └── types/ # TypeScript type definitions
├── build/ # Compiled JavaScript files
├── package.json # Project dependencies and scripts
└── README.md # This documentation

🔌 API リファレンス

この MCP サーバーでは、次の API エンドポイントを使用します。

• GET /sarcasm/all - 皮肉な名言をすべて取得します
• GET /sarcasm/random - ランダムな皮肉な名言を取得します

レスポンスは次の形式で返されます。

interface SarcasticQuote {
    id: string;
    sarcasm: string;
    createdAt: string;
    updatedAt: string;
}

🤝 貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📝 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細はLICENSEファイルをご覧ください。