Schema.org MCP 服务器

一个提供对 schema.org 词汇表访问的 MCP（模型上下文协议）服务器，用于结构化数据。

功能

• 获取模式类型：检索有关任何 schema.org 类型的详细信息
• 搜索模式：通过关键词搜索 schema 类型
• 类型层次结构：探索类型之间的继承关系
• 类型属性：列出类型的所有可用属性（包括继承的）
• 生成示例：为任何 schema 类型创建示例 JSON-LD

安装

# 克隆仓库
git clone https://github.com/yourusername/schema-org-mcp.git
cd schema-org-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行服务器
npm start

使用方法

与 Claude Desktop 集成

在你的 Claude Desktop 配置中添加以下内容（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "schema-org": {
      "command": "node",
      "args": ["/path/to/schema-org-mcp/dist/index.js"]
    }
  }
}

可用工具

1. get_schema_type

获取 schema.org 类型的详细信息。

{
  "typeName": "Person"
}

2. search_schemas

通过关键词搜索 schema 类型。

{
  "query": "article",
  "limit": 10
}

3. get_type_hierarchy

获取类型的继承层次结构。

{
  "typeName": "NewsArticle"
}

4. get_type_properties

获取类型的所有可用属性。

{
  "typeName": "Organization",
  "includeInherited": true
}

5. generate_example

为类型生成示例 JSON-LD。

{
  "typeName": "Recipe",
  "properties": {
    "name": "Chocolate Chip Cookies",
    "prepTime": "PT20M"
  }
}

开发

# 在监视模式下运行 TypeScript 编译器
npm run dev

# 运行测试
npm test

# 为生产构建
npm run build

工作原理

服务器下载并缓存完整的 schema.org 词汇表，以 JSON-LD 格式存储。然后提供各种工具来：

1. 查询类型定义及其属性
2. 导航类型层次结构
3. 生成有效的 JSON-LD 示例
4. 搜索整个词汇表

数据从官方 schema.org 的 JSON-LD 文件中获取，并在内存中进行索引以实现快速访问。

示例

查找网站类型

用户： "我应该为一篇博客文章使用哪些 schema 类型？"

助手使用： search_schemas，查询 "blog"
然后： get_type_hierarchy，针对 "BlogPosting"
最后： generate_example，针对 "BlogPosting"

理解类型属性

用户： "我可以为产品使用哪些属性？"

助手使用： get_type_properties，针对 "Product"，并设置 includeInherited: true

贡献

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

许可证

MIT 许可证 - 详情见 LICENSE 文件。 </中文翻译>