MCP Bonusly

mcp bonely


Bonely员工识别平台的综合MCP服务器

MCP服务器与Bonly API交互，通过Claude和其他MCP客户管理员工表彰奖金。

🚀 可用时间： 史密瑟里 便于本地安装！

目录

• 快速开始
• 特性
• 安装
• 设置
• 可用工具
• 示例提示
• 发展
• 许可证

快速开始

快速安装

git clone https://github.com/ajramos/mcp-bonusly
cd mcp-bonusly
uv sync

快速设置

1. 从获取Bonly API代币https://bonus.ly/api
2. 创建一个 .env 使用您的令牌创建文件：

   BONUSLY_API_TOKEN=your_api_token_here

1. 配置Claude Desktop以使用服务器

特性

✨ 完整的奖金管理

• 列出奖金 具有高级过滤功能（包括用于团队分析的新useremail参数）
• 创建新奖金 通过验证
• 检索奖金详细信息 特定奖金

🔍 高级过滤

• 按日期范围筛选
• 按发件人电子邮件筛选
• 按收件人电子邮件筛选
• 按标签筛选
• 限制结果数量

🛡️ 安全

• 使用API令牌进行安全身份验证
• 输入数据验证
• 稳健的错误处理

安装

选项1：从Smithery安装（推荐）

此MCP可在 史密瑟里 作为本地安装：

1. 访问 史密瑟里
2. 搜索“mcp bonusly”
3. 遵循本地MCP的安装说明
4. 配置Bonally API令牌（请参阅下面的“设置”部分）

选项2：使用紫外线手动安装

git clone https://github.com/ajramos/mcp-bonusly
cd mcp-bonusly
uv sync

选项3：使用pip手动安装

git clone https://github.com/ajramos/mcp-bonusly
cd mcp-bonusly
pip install -e .

设置

1.获取Bonly API代币

1. 首选https://bonus.ly/api
2. 登录您的Bonusly帐户
3. 创建新的API令牌
4. 复制生成的令牌

2.配置环境变量

创建一个 .env 项目根目录中的文件：

BONUSLY_API_TOKEN=your_api_token_here

3.配置克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "mcp-bonusly": {
      "command": "uv",
      "args": [
        "--directory", 
        "/full/path/to/mcp-bonusly",
        "run",
        "mcp-bonusly"
      ],
      "env": {
        "BONUSLY_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

可用工具

🎁 list_bonuses

列出带有可选过滤器的奖金。

参数：

• limit （可选）：要返回的奖金数量（1-100，默认值：20）
• start_date （可选）：开始日期（格式：YYYY-MM-DD）
• end_date （可选）：结束日期（格式：YYYY-MM-DD）
• giver_email （可选）：发件人的电子邮件地址
• receiver_email （可选）：收件人的电子邮件地址
• user_email （可选）：用户的电子邮件地址（该用户给予或收到的奖金）。 建议用于团队分析：单独搜索每个团队成员，以确保完全覆盖。
• hashtag （可选）：要过滤的标签（例如#teamwork）
• include_children （可选）：包括奖励回复

🆕 create_bonus

创建新的认可奖金。

参数：

• giver_email （可选）：赠送者的电子邮件地址（仅限管理员，普通用户以自己的名义发送奖金）
• reason （必填）：奖金原因（例如，“#团队合作+10@用户”）
• parent_bonus_id （可选）：用于回复的家长奖励ID

🔍 get_bonus

获取特定奖金的详细信息。

参数：

• bonus_id （必填）：要检索的奖金ID

示例提示

列出最近的奖金

"Show me the last 10 bonuses given"

创建奖金

"Create a 5-point bonus for john@company.com for excellent work on the project with #teamwork"

按标签搜索奖金

"Show me all bonuses with hashtag #innovation from last month"

获取奖金详细信息

"Get details for bonus with ID 24abcdef1234567890abcdef"

发展

设置开发环境

git clone https://github.com/ajramos/mcp-bonusly
cd mcp-bonusly
uv sync
uv run mcp-bonusly

使用MCP检查器进行调试

为了获得最佳的调试体验，我们建议使用MCP检查器：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-bonusly run mcp-bonusly

查看服务器日志

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-bonusly.log

# Linux 
tail -n 20 -f ~/.config/Claude/logs/mcp-server-mcp-bonusly.log

# Windows
Get-Content "$env:APPDATA\Claude\logs\mcp-server-mcp-bonusly.log" -Wait -Tail 20

项目结构

mcp-bonusly/
├── src/
│   └── mcp_bonusly/
│       ├── __init__.py
│       ├── server.py          # Main MCP server
│       ├── client.py          # Bonusly API client
│       ├── models.py          # Pydantic models
│       └── exceptions.py      # Custom exceptions
├── tests/                     # Tests (coming soon)
├── .env.example              # Environment variables example
├── .gitignore
├── README.md
├── pyproject.toml
└── LICENSE

安全

• 所有凭据都通过环境变量处理
• API令牌存储安全
• 除Bonly API外，不向第三方发送任何数据
• 所有操作的输入验证

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/new-feature)
3. 提交您的更改(git commit -am 'Add new feature')
4. 推到分支(git push origin feature/new-feature)
5. 打开拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

支持

如果您遇到任何问题：

1. 检查日志 使用上面的调试说明
2. 验证您的API令牌 在 .env 文件
3. 打开一个问题 与：

- 您的操作系统 - Python版本 - 错误消息或日志 - 重现问题的步骤

关于Bonely

Bonusly是一个员工认可平台，使公司能够创造一种欣赏和参与的文化。员工可以通过反映公司价值观的个性化信息和标签互相打分。

______________________________________________________________________

创建于❤️ 安吉尔·拉莫斯