{"_id":"@dhcckb/mcp-server-dh-people-relations","_rev":"3-85877daa1159c6eb6eab03d0ac3774ba","name":"@dhcckb/mcp-server-dh-people-relations","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@dhcckb/mcp-server-dh-people-relations","version":"1.0.0","keywords":["mcp","mcp-server","digital-humanities","classical-chinese-literature","knowledge-graph","people-relations"],"license":"MIT","_id":"@dhcckb/mcp-server-dh-people-relations@1.0.0","maintainers":[{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"}],"bin":{"mcp-server-dh-people-relations":"dist/index.js"},"mcp":{"tools":[{"name":"resolve_person","description":"根据人物姓名调用古典文献知识图谱 People API，返回人物详情（含数字 ID、朝代、别名等），供后续查询使用。若存在重名，返回候选列表供用户选择。","inputSchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"人物姓名（如\"苏轼\"），直接作为路径参数传入 GET /api/People/{name}。"}}}},{"name":"query_relations","description":"统一入口工具。仅传入 personName 时，调用 GET /api/People/{id}/Mentionship 返回该人物所有交游关系概览 CSV（含聚合的 mentionCount 和 representativeWork）。同时传入 personName 和 targetName 时，先分别解析两人 ID，再分页调用 GET /api/People/{id}/Mentionship/{targetId} 获取两人间述及作品列表 CSV。含自动翻页、超时重试、50 页上限保护；超上限时返回摘要统计而非全量数据。","inputSchema":{"type":"object","required":["personName"],"properties":{"pageNo":{"type":"number","description":"起始页码（可选，默认 0）。用于手动指定继续翻页的起点，仅当上次返回 truncated=true 时可用。"},"pageSize":{"type":"number","description":"每页条数（可选，默认 20）。"},"personName":{"type":"string","description":"源人物姓名（必填），如\"苏轼\"。"},"targetName":{"type":"string","description":"被述及人物姓名（可选），如\"黄庭坚\"。"}}}}]},"dist":{"shasum":"8d4a70196bae97714f32f0bdef3873b50da4c212","tarball":"https://registry.npmjs.org/@dhcckb/mcp-server-dh-people-relations/-/mcp-server-dh-people-relations-1.0.0.tgz","fileCount":10,"integrity":"sha512-1KrcmoLBiZoFxpPG1YnHmFN3Xq1O1bS5xi5HggaFdgyzEuyU+1eblqIL1mOJJe+s5DMlPLuYTVuGkTQXZO6ITg==","signatures":[{"sig":"MEYCIQCwF5WoQoT7nWE9Rt4l4ZbcpWn+Coj8x8lbrdzzK6yQbgIhAMm1JTTA8NihzXF9PIXyXcwL+SzOnabckrkV25jOZU++","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53580},"main":"dist/index.js","_from":"file:/tmp/dhp-agent-npm-jnhEJJ/package.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"},"_resolved":"/tmp/dhp-agent-npm-jnhEJJ/package.tgz","_integrity":"sha512-1KrcmoLBiZoFxpPG1YnHmFN3Xq1O1bS5xi5HggaFdgyzEuyU+1eblqIL1mOJJe+s5DMlPLuYTVuGkTQXZO6ITg==","_npmVersion":"10.9.1","description":"人物交游关系查询 MCP Server — 封装古典文献知识图谱开放 API，支持人物姓名解析、交游关系概览与两人间述及作品查询","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-dh-people-relations_1.0.0_1785377386557_0.37491766758374623","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@dhcckb/mcp-server-dh-people-relations","version":"1.0.1","keywords":["mcp","mcp-server","digital-humanities","classical-chinese-literature","knowledge-graph","people-relations"],"license":"MIT","_id":"@dhcckb/mcp-server-dh-people-relations@1.0.1","maintainers":[{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"}],"bin":{"mcp-server-dh-people-relations":"dist/index.js"},"mcp":{"tools":[{"name":"resolve_person","description":"根据人物姓名调用古典文献知识图谱 People API，返回人物详情（含数字 ID、朝代、别名等），供后续查询使用。若存在重名，返回候选列表供用户选择。","inputSchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"人物姓名（如\"苏轼\"），直接作为路径参数传入 GET /api/People/{name}。"}}}},{"name":"query_relations","description":"统一入口工具。仅传入 personName 时，调用 GET /api/People/{id}/Mentionship 返回该人物所有交游关系概览 CSV（含聚合的 mentionCount 和 representativeWork）。同时传入 personName 和 targetName 时，先分别解析两人 ID，再分页调用 GET /api/People/{id}/Mentionship/{targetId} 获取两人间述及作品列表 CSV。含自动翻页、超时重试、50 页上限保护；超上限时返回摘要统计而非全量数据。","inputSchema":{"type":"object","required":["personName"],"properties":{"pageNo":{"type":"number","description":"起始页码（可选，默认 0）。用于手动指定继续翻页的起点，仅当上次返回 truncated=true 时可用。"},"pageSize":{"type":"number","description":"每页条数（可选，默认 20）。"},"personName":{"type":"string","description":"源人物姓名（必填），如\"苏轼\"。"},"targetName":{"type":"string","description":"被述及人物姓名（可选），如\"黄庭坚\"。"}}}}]},"dist":{"shasum":"60e703e9c660500283af8305f1a16861b220d515","tarball":"https://registry.npmjs.org/@dhcckb/mcp-server-dh-people-relations/-/mcp-server-dh-people-relations-1.0.1.tgz","fileCount":10,"integrity":"sha512-VjgZCgojY/tde4q8pMndBc60fnN0xGYX5Ucc8FdZi9WF5sKYz6cnF4eUyylApzEfqEVKmmdN1NsTcxiXwhU6wQ==","signatures":[{"sig":"MEQCIAf4OmsLvibOj3he1C1vXfXs8nb4BpcZ/jB6ETPSNHTbAiAgn18KIz2KAmPr1MQzlTMtB5+pa+naHphNQ+cRhyZE9w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53709},"main":"dist/index.js","_from":"file:/tmp/dhp-agent-npm-edphoD/package.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"},"_resolved":"/tmp/dhp-agent-npm-edphoD/package.tgz","_integrity":"sha512-VjgZCgojY/tde4q8pMndBc60fnN0xGYX5Ucc8FdZi9WF5sKYz6cnF4eUyylApzEfqEVKmmdN1NsTcxiXwhU6wQ==","_npmVersion":"10.9.1","description":"人物交游关系查询 MCP Server — 封装古典文献知识图谱开放 API，支持人物姓名解析、交游关系概览与两人间述及作品查询","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-dh-people-relations_1.0.1_1785379874159_0.7751376937529966","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@dhcckb/mcp-server-dh-people-relations","version":"1.0.2","description":"人物交游关系查询 MCP Server — 封装古典文献知识图谱开放 API，支持人物姓名解析、交游关系概览与两人间述及作品查询","main":"dist/index.js","bin":{"mcp-server-dh-people-relations":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"mcp":{"tools":[{"name":"resolve_person","description":"根据人物姓名调用古典文献知识图谱 People API，返回人物详情（含数字 ID、朝代、别名等），供后续查询使用。若存在重名，返回候选列表供用户选择。保留为独立便捷工具。","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"人物姓名，工具内部自动进行UTF-8 URL百分号编码，再调用GET /api/People/{encodedName} 获取人物档案。示例：\"苏轼\""}},"required":["name"]}},{"name":"query_relations","description":"统一入口工具。传入 id（人物姓名或数字 ID，必填），可选传入 targetId（目标人物姓名或数字 ID）。string 值自动 UTF-8 编码后调 /api/People/{encodedName} 解析为数字 ID；integer 值直接作为 ID 使用。仅传入 id 时调 GET /api/People/{id}/Mentionship 获取该人物所有交游关系概览 CSV（含聚合的 mentionCount 和 representativeWork）。同时传入 id 和 targetId 时调 GET /api/People/{id}/Mentionship/{targetId} 获取两人间述及作品列表 CSV。含自动翻页、超时重试、50 页上限保护；超上限时返回摘要统计而非全量数据。参数类型错误、人物未找到、API 调用失败均返回中文错误提示。","inputSchema":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}],"description":"源人物 ID 或人物姓名（必填）。整数视为人物 ID 直接使用；字符串视为人物姓名，自动 UTF-8 编码后调用 /api/People/{encodedName} 获取 ID。"},"targetId":{"anyOf":[{"type":"string"},{"type":"integer"}],"description":"目标人物 ID 或人物姓名（可选）。处理规则同 id 参数。"},"pageNo":{"type":"integer","description":"起始页码（可选，默认 0）。用于手动指定继续翻页的起点，仅当上次返回 truncated=true 时可用。"},"pageSize":{"type":"integer","description":"每页条数（可选，默认 20）。"}},"required":["id"]}}]},"keywords":["mcp","mcp-server","digital-humanities","classical-chinese-literature","knowledge-graph","people-relations"],"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.3.0"},"_id":"@dhcckb/mcp-server-dh-people-relations@1.0.2","types":"./dist/index.d.ts","_integrity":"sha512-nykqqNQzx9fFvIrRwLMdW2GUbqAv9JfW08MAUGuKzsoOFMXVq2GyCg6L8V0bx7hsaKbh+YMavraLjHAVZnWbTw==","_resolved":"/tmp/dhp-agent-npm-nmKLiB/package.tgz","_from":"file:/tmp/dhp-agent-npm-nmKLiB/package.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.1","dist":{"integrity":"sha512-nykqqNQzx9fFvIrRwLMdW2GUbqAv9JfW08MAUGuKzsoOFMXVq2GyCg6L8V0bx7hsaKbh+YMavraLjHAVZnWbTw==","shasum":"3a393edc357514ce1beac07b302c4cc0f44389b6","tarball":"https://registry.npmjs.org/@dhcckb/mcp-server-dh-people-relations/-/mcp-server-dh-people-relations-1.0.2.tgz","fileCount":10,"unpackedSize":60636,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGmp9YyiDViOry5SPSPc4Lf2DKKX4nLsnEhIRK5FfDtqAiEAnpl2XVh8I5iyfjnDqpeYtO3Ad+6BB8EKHfRdRR6TqqA="}]},"_npmUser":{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"},"directories":{},"maintainers":[{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-dh-people-relations_1.0.2_1785405585222_0.8493831661197375"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-30T02:09:46.257Z","modified":"2026-07-30T09:59:45.652Z","1.0.0":"2026-07-30T02:09:46.703Z","1.0.1":"2026-07-30T02:51:14.327Z","1.0.2":"2026-07-30T09:59:45.367Z"},"license":"MIT","keywords":["mcp","mcp-server","digital-humanities","classical-chinese-literature","knowledge-graph","people-relations"],"description":"人物交游关系查询 MCP Server — 封装古典文献知识图谱开放 API，支持人物姓名解析、交游关系概览与两人间述及作品查询","maintainers":[{"name":"thudh","email":"tangchen@mail.tsinghua.edu.cn"}],"readme":"# 人物交游关系查询 MCP Server\n\n封装[古典文献知识图谱开放 API](https://open.cnkgraph.com) 的人物交游关系查询能力，提供两个 MCP 工具：\n\n- **resolve_person** — 根据人物姓名查询人物详情（含数字 ID、朝代、别名）。\n- **query_relations** — 查询交游关系概览（仅 personName）或两人间述及作品列表（personName + targetName），含自动分页、超时重试与 50 页上限保护。\n\n## 安装\n\n```bash\nnpx -y @dhcckb/mcp-server-dh-people-relations\n```\n\n## 配置\n\n| 环境变量 | 默认值 | 说明 |\n|---------|--------|------|\n| `CNKGRAPH_BASE_URL` | `https://open.cnkgraph.com` | API 基准地址，可通过此变量覆盖 |\n\n## 使用示例\n\n### 解析人物\n\n```json\n{ \"name\": \"resolve_person\", \"arguments\": { \"name\": \"苏轼\" } }\n```\n\n### 查询交游关系概览\n\n```json\n{ \"name\": \"query_relations\", \"arguments\": { \"personName\": \"苏轼\" } }\n```\n\n### 查询两人间述及作品\n\n```json\n{ \"name\": \"query_relations\", \"arguments\": { \"personName\": \"苏轼\", \"targetName\": \"黄庭坚\" } }\n```\n\n## 许可\n\nMIT\n","readmeFilename":"README.md"}