Sarcasm MCP Server

Sarcasm MCP Server

一个提供讽刺语录的模型上下文协议（MCP）服务。此 MCP 服务可与 AI Agent 集成，生成诙谐、讽刺的回复。

🚀 功能

• 获取所有讽刺语录：检索所有可用的讽刺语录
• 获取随机讽刺语录：获取一条随机讽刺语录，供您欣赏
• MCP 集成：可与任何支持模型上下文协议的环境无缝集成

📋 要求

• 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 服务可与 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;
}

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

📝 许可证

此项目采用 MIT 许可证，详情请参阅 LICENSE 文件。