Skip to main content
Glama

Calligraphy MCP - 书法知识问答与教学服务

一个专注于中国书法知识问答、指导与教学的 MCP(Model Context Protocol)服务。

功能特点

  • 书法知识问答:回答书法学习、创作、历史、审美等各方面的问题

  • 学习计划制定:根据用户水平和目标,提供个性化的学习计划

  • 名家信息查询:查询历代书法名家的生平、代表作品、风格特点

  • 技法指导:提供执笔、运笔、笔画写法、书体特点等详细技法讲解

  • 美学探讨:探讨书法美学与哲学,包括审美标准、艺术鉴赏等

  • 常见问题解答:解决书法学习过程中的各种困惑

Related MCP server: China Festival MCP Server

可配置参数

参数名

类型

可选值

默认值

说明

level

string

beginner, intermediate, advanced

beginner

用户书法水平等级

  • beginner(初学者):0-3个月,正在学习基础笔画和简单汉字结构

  • intermediate(进阶者):3-12个月,已掌握基本笔画,正在深入临帖和学习结构

  • advanced(高级者):1年以上,已具备扎实基础,正在追求艺术表达和风格形成

安装与使用

方式一:全局安装(推荐)

npm install -g calligraphy-mcp

方式二:本地安装

git clone https://github.com/your-repo/calligraphy-mcp.git
cd calligraphy-mcp
npm install
npm run build

在 Claude Desktop 中配置

编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "calligraphy": {
      "command": "node",
      "args": ["/path/to/calligraphy-mcp/dist/index.js"],
      "env": {
        "CALLIGRAPHY_DEFAULT_LEVEL": "intermediate"
      }
    }
  }
}

如果使用全局安装:

{
  "mcpServers": {
    "calligraphy": {
      "command": "calligraphy-mcp",
      "args": [],
      "env": {
        "CALLIGRAPHY_DEFAULT_LEVEL": "intermediate"
      }
    }
  }
}

在 Trae IDE 中配置

在 MCP 设置中添加:

{
  "calligraphy": {
    "command": "node",
    "args": ["d:\\phpstudy_81\\WWW\\self\\shufa-mcp\\dist\\index.js"],
    "env": {
        "CALLIGRAPHY_DEFAULT_LEVEL": "intermediate"
    }
  }
}

工具说明

1. query_calligraphy - 书法知识问答

{
  "question": "什么是永字八法?",
  "level": "beginner"
}

2. get_learning_plan - 获取学习计划

{
  "current_level": "beginner",
  "goal": "系统学习楷书",
  "daily_minutes": 30
}

3. get_master_info - 查询名家信息

{
  "master_name": "王羲之"
}

4. get_technique_guide - 获取技法指导

{
  "technique_type": "grip",
  "level": "beginner"
}

5. get_aesthetic_insight - 探讨书法美学

{
  "topic": "书法与人生",
  "level": "advanced"
}

6. get_common_questions - 常见问题解答

{
  "category": "beginner"
}

知识库内容

本项目包含以下知识库文档:

文档

内容

beginner-guide.md

书法初学者入门指南

calligraphy-history.md

中国书法历史与书体演变

calligraphy-techniques.md

书法笔法技法详解

calligraphy-masters.md

历代书法名家与传世名作

calligraphy-creation.md

书法创作与章法

calligraphy-aesthetics.md

书法审美与哲学

learning-plan.md

书法学习计划与练习方法

common-questions.md

书法常见问题与答疑

开发

# 开发模式(监听文件变化)
npm run dev

# 构建
npm run build

# 运行
npm start

项目结构

calligraphy-mcp/
├── src/
│   └── index.ts          # MCP 服务入口
├── knowledge/            # 书法知识库
│   ├── 01-beginner-guide.md
│   ├── 02-calligraphy-history.md
│   ├── 03-calligraphy-techniques.md
│   ├── 04-calligraphy-masters.md
│   ├── 05-calligraphy-creation.md
│   ├── 06-calligraphy-aesthetics.md
│   ├── 07-learning-plan.md
│   └── 08-common-questions.md
├── dist/                 # 编译输出
├── package.json
├── tsconfig.json
└── README.md

许可证

MIT

Available Tools

6 tools
get_aesthetic_insightC

探讨书法美学与哲学,包括审美标准、艺术鉴赏、书法文化价值等深度内容。

Inputs: level, topic.

get_common_questionsA

获取书法学习中常见问题的解答,帮助用户解决学习过程中的困惑。

Inputs: category.

get_learning_planA

为用户制定个性化的书法学习计划。根据用户当前水平和目标,提供阶段性的学习建议。

Inputs: goal, current_level, daily_minutes.

get_master_infoA

查询历代书法名家的信息,包括生平、代表作品、风格特点等。

Inputs: master_name (required).

get_technique_guideA

获取书法技法指导,包括执笔、运笔、笔画写法、书体特点等详细技法讲解。

Inputs: level, technique_type.

query_calligraphyA

查询书法知识,回答书法相关问题。适用于书法学习、创作、历史、审美等各方面的知识问答。

Inputs: question (required), level.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation3/5

    The specialized tools like get_master_info, get_technique_guide, and get_aesthetic_insight are clearly distinct. However, query_calligraphy is a broad catch-all that overlaps with all of them, especially get_common_questions, making tool selection somewhat ambiguous.

    Naming Consistency4/5

    Five of six tools follow a consistent get_* pattern with clear noun descriptors. query_calligraphy deviates from this pattern but is still readable and understandable in context.

    Tool Count5/5

    Six tools is a well-scoped size for a calligraphy knowledge and learning assistant. Each specialized tool covers a meaningful aspect of the domain without unnecessary redundancy.

    Completeness5/5

    The tool surface covers masters, techniques, aesthetics, common questions, general queries, and personalized learning plans. For a knowledge-oriented MCP server, this provides comprehensive coverage with no obvious dead ends.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables traditional Chinese fortune-telling through BaZi (Four Pillars) analysis, including solar/lunar date conversion, Five Element balance calculations, Ten Gods deduction, and destiny interpretation for metaphysics applications.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides Chinese holiday information, lunar calendar conversion, traditional festivals, 24 solar terms, and BaZi (Eight Characters) calculations for AI assistants to accurately handle Chinese calendar queries and date conversions.
      3
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables natural-language Chinese queries across MySQL, Dameng DM, and KingbaseES databases, with safe SQL generation, schema exploration, and read-only query execution.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables users to search Chinese poems by title, content, author, dynasty, or category; check recitations and dictation; generate appreciation text; create TTS recitations with subtitles; and produce calligraphy practice sheets.
      MIT