🚀 独立有功者荣誉记录 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 配置

1. 打开终端并运行以下命令：

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

2. 打开 ~/.config/anthropic/keys.json 文件并添加您的 API 密钥：

{
  "ANTHROPIC_API_KEY": "your-api-key-here"
}

Windows 配置

1. 打开命令提示符并运行以下命令：

echo {
  ^
  "ai": {
    ^
    "client": "claude-sonnet",
    ^
    "model": "anthropic/claude-3-sonnet",
    ^
    "api_key_path": "%APPDATA%\Claude\keys.json"
  },
  ^
  "log_level": "INFO"
} > "%ProgramData%\Claude\settings.json"

2. 打开 C:\Users\<username>\AppData\Roaming\Claude\keys.json 文件并添加您的 API 密钥：

{
  "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

🔧 技术细节

工作原理

1. 服务器发现：客户端通过网络发现 MCP 服务器。
2. 协议协商：客户端与服务器之间进行协议版本协商。
3. 命令执行：根据协商结果，客户端发送具体命令并由服务器处理。

📄 许可证

MIT License

版权 (c) 2024

准许任何人免费使用、复制、修改、合并、发布、分发、 sublicense 和/或出售此软件及其关联的文档文件（“软件”），且无限制，包括但不限于为任何目的而使用的权利。

软件按“原样”提供，不做任何形式的保证，包括但不限于对适销性、适合特定用途和非侵权性的保证。在因合同、 TORT 或其他行为导致的任何主张、损害或其他责任中，作者或版权持有者概不负责。

此仓库使用 Anthropic 的 Claude 3.7 声调模型编写。