🚀 独立有功者荣誉记录 MCP 服务器
本 MCP 服务器主要用于查询独立有功者的荣誉记录，能够根据指定条件获取相关荣誉信息，还可生成详细的公抁报告，同时提供 RESTful API 进行程序化操作，为相关数据的管理和使用提供了便利。
🚀 快速开始
在使用本服务器之前，请先做好准备工作，完成安装、环境变量配置等步骤，以下是详细说明。
✨ 主要特性
- 查询独立有功者荣誉记录：通过指定条件获取相关荣誉记录信息。
- 生成公抁报告：根据提供的数据生成详细的公抁报告。
- API 接口：提供 RESTful API 用于程序化操作。
📦 安装指南
克隆仓库
在终端中运行以下命令以克隆此仓库：
git clone https://github.com/your-repository.git
cd independent-contributors-honors-mcp-server
安装依赖项
使用以下命令安装必要的 Python 包：
uv pip install -e .
🔧 环境变量配置
复制 env-sample 文件并将其命名为 .env：
cp env-sample .env
然后根据需要编辑 .env 文件以配置环境。
💻 使用示例
Claude Desktop 使用方法
macOS 配置
- 打开终端并运行以下命令：
echo '{
"ai": {
"client": "claude-sonnet",
"model": "anthropic/claude-3-sonnet",
"api_key_path": "~/.config/anthropic/keys.json"
},
"log_level": "INFO"
}' > $(xdg-user-docdir)/Claude/settings.json
- 打开
~/.config/anthropic/keys.json文件并添加您的 API 密钥：
{
"ANTHROPIC_API_KEY": "your-api-key-here"
}
Windows 配置
- 打开命令提示符并运行以下命令：
echo {
^
"ai": {
^
"client": "claude-sonnet",
^
"model": "anthropic/claude-3-sonnet",
^
"api_key_path": "%APPDATA%\Claude\keys.json"
},
^
"log_level": "INFO"
} > "%ProgramData%\Claude\settings.json"
- 打开
C:\Users\文件并添加您的 API 密钥：\AppData\Roaming\Claude\keys.json
{
"ANTHROPIC_API_KEY": "your-api-key-here"
}
API 使用方法
接口说明
查询荣誉记录
GET /honors?name={name}&year={year}
生成公抁报告
POST /reports
Content-Type: application/json
{
"data": {
"entries": [ ... ]
}
}
基础用法
查询独立有功者荣誉记录
在终端中运行以下命令以查询特定独立有功者的荣誉记录：
independent-contributors-honors-mcp-server get-honors --name "李大" --year 2023
生成公抁报告
使用以下命令生成年度公抁报告：
independent-contributors-honors-mcp-server generate-report --year 2023
🔧 技术细节
工作原理
- 服务器发现：客户端通过网络发现 MCP 服务器。
- 协议协商：客户端与服务器之间进行协议版本协商。
- 命令执行：根据协商结果，客户端发送具体命令并由服务器处理。
📄 许可证
MIT License
版权 (c) 2024
准许任何人免费使用、复制、修改、合并、发布、分发、 sublicense 和/或出售此软件及其关联的文档文件（“软件”），且无限制，包括但不限于为任何目的而使用的权利。
软件按“原样”提供，不做任何形式的保证，包括但不限于对适销性、适合特定用途和非侵权性的保证。在因合同、 TORT 或其他行为导致的任何主张、损害或其他责任中，作者或版权持有者概不负责。
此仓库使用 Anthropic 的 Claude 3.7 声调模型编写。