Handsontable MCP Server

手持MCP服务器

模型上下文协议服务器，提供对可手持文档的访问，用于AI驱动的代码生成。

特性

• 三个MCP工具

- get_doc -以Markdown格式获取特定文档页面 - search_docs -按关键字搜索563页 - list_categories -浏览所有文档类别

• 多框架支持

- JavaScript（香草） - 反应 - Angular - Vue 2/3（通过集成指南）

• 智能功能

- 输入验证和净化 - 速率限制（请求之间100ms） - LRU缓存，1小时TTL（最多100个项目） - 结构化JSON日志记录 - HTML到Markdown的转换

• 覆盖

- 61个API终点 - 128个指导主题 - 20个文件类别 - 共563页

快速设置

1.克隆和安装

git clone https://github.com/GreenFlux/handsontable-mcp-server.git
cd handsontable-mcp-server
npm install

2.添加到克劳德桌面

macOS： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： 编辑 %APPDATA%\Claude\claude_desktop_config.json

替换 /absolute/path/to 根据您的实际路径：

{
  "mcpServers": {
    "handsontable": {
      "command": "node",
      "args": ["/absolute/path/to/handsontable-mcp-server/index.js"]
    }
  }
}

3.重新启动克劳德桌面

当Claude Desktop启动时，服务器会自动启动。

使用服务器

连接后，向Claude询问Handontable：

可用工具

1. get_doc

获取特定文档并以Markdown格式返回。

参数：

• topic （必填）：文档主题（例如“列排序”、“过滤器”）
• framework （可选）：“javascript”、“react”或“angular”（默认为“javascript”）
• type （可选）：“guide”或“api”（默认：“guide”）

例子：

Get the React column sorting documentation

2. search_docs

按关键字搜索主题。

参数：

• keyword （必填）：搜索词

例子：

Search Handsontable docs for "filter"

3. list_categories

列出所有文档类别和主题。

例子：

Show me all Handsontable documentation categories

看 文件.md 获取所有61个API端点、128个指南主题和20个类别的完整参考。

发展

使用自动重新加载运行：

npm run dev

运行测试：

npm test

棉绒编码：

npx eslint .

格式代码：

npx prettier --write .

建筑

服务器：

1. 通过stdio接收MCP工具请求
2. 验证并净化所有输入
3. 应用速率限制（请求之间100毫秒）
4. 从handcontable.com获取HTML
5. 使用JSDOM解析，删除导航/页脚
6. 通过调低转换为Markdown
7. 缓存导致LRU被驱逐
8. 返回格式化文档

项目结构

handsontable-mcp-server/
├── index.js                 # Main MCP server
├── test.js                  # Test suite
├── docs-structure.json      # Pre-analyzed docs
├── .github/
│   └── workflows/
│       └── ci.yml          # GitHub Actions
└── README.md

贡献

欢迎投稿！请阅读 贡献.md 第一。

安全

看 安全.md 用于安全策略和漏洞报告。

许可证

麻省理工学院-参见 许可证 了解详情。

致谢

• 文件来源： 可手持
• 内置于 模型上下文协议SDK