Demosdk MCP Server

演示SDK MCP服务器

MCP（模型上下文协议）服务器，提供对Demos Network SDK文档的访问。该服务器抓取Demos Network GitBook文档并为其编制索引，使其可通过人工智能助手的MCP工具进行搜索和访问。

安装

运行安装脚本：

chmod +x install.sh
./install.sh

这将：

• 复制Demos SDK配置文件
• 安装依赖项
• 构建项目
• 全局安装，便于访问

配置

快速开始

Demos SDK MCP服务器是为Demos Network文档预先配置的：

# Already configured for https://docs.kynesys.xyz
npm start

服务器包括：

• 预先配置访问Demos Network文档的权限
• Demos SDK特定的工具前缀(demos_network_sdk_)
• 多链、XM、web2、DAHR和跨链功能的关键字

高级配置

服务器已针对Demos Network进行了预配置，但您可以在中自定义设置 .env.demosdk:

预配置设置：

• GITBOOK_URL=https://docs.kynesys.xyz -Demos网络文档
• SERVER_NAME=demos-network-docs -服务器标识符
• TOOL_PREFIX=demos_network_sdk_ -工具命名前缀
• DOMAIN_KEYWORDS -包括演示、sdk、多链、xm、web2、dahr、交叉链

性能设置：

• CACHE_TTL_HOURS=1 -缓存过期时间
• MAX_CONCURRENT_REQUESTS=5 -平行刮擦限制
• SCRAPING_DELAY_MS=100 -请求之间的延迟

定制： 要修改配置，请编辑 .env.demosdk 或创建新 .env 使用您的自定义设置创建文件。

用法

运行服务器

npm start

在Claude Desktop中安装

运行安装脚本后，添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "demos-sdk": {
      "command": "demosdk-mcp-server"
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加到克劳德代码

claude mcp add demosdk-mcp-server

MCP检验员测试

npx @modelcontextprotocol/inspector node dist/index.js

作为REST API运行

# Start REST API server on port 3000
npm run start:api

# Or specify custom port
PORT=8080 npm run start:api

REST API为所有MCP功能提供HTTP端点：

# API documentation
curl http://localhost:3000/api

# Search content
curl "http://localhost:3000/api/search?q=authentication"

# Get specific page
curl http://localhost:3000/api/page/sdk/websdk

# Get page as markdown
curl http://localhost:3000/api/page/sdk/websdk/markdown

# Get code blocks from page
curl http://localhost:3000/api/page/api/endpoints/code

# List all sections
curl http://localhost:3000/api/sections

# Get pages in a section
curl http://localhost:3000/api/sections/SDK/pages

# Server status and stats
curl http://localhost:3000/api/status

# Refresh content cache
curl -X POST http://localhost:3000/api/refresh

可用工具

Demos SDK MCP服务器公开了以下工具 demos_network_sdk_ 前缀：

核心工具：

1. demos_network_sdk_search_content -在Demos Network文档中搜索

- query （string）：使用模糊匹配和词干的搜索查询

1. demos_network_sdk_get_page -获取特定的文档页面

- path （string）：页面路径（例如，“/sdk/gette-start”）

1. demos_network_sdk_list_sections -获取完整的目录

1. demos_network_sdk_get_section_pages -获取一个部分中的所有页面

- section （string）：节名称（例如“SDK参考”）

1. demos_network_sdk_refresh_content -强制刷新缓存内容

1. demos_network_sdk_get_code_blocks -使用语法高亮显示提取代码块

- path （string）：页面路径（例如，“/sdk/example.”）

1. demos_network_sdk_get_markdown -获取格式化的markdown页面内容

- path （string）：页面路径（例如，“/api/reference”）

MCP提示：

1. explain_section -生成全面的章节教程
2. summarize_page -创建简洁的页面摘要
3. compare_sections -比较不同的文档部分
4. api_reference -将内容格式化为API文档
5. quick_start_guide -生成快速入门指南

示例用法

使用Demos SDK MCP服务器工具：

# Search for SDK documentation
{"tool": "demos_network_sdk_search_content", "arguments": {"query": "multichain integration"}}

# Get a specific page
{"tool": "demos_network_sdk_get_page", "arguments": {"path": "/sdk/getting-started"}}

# List all sections
{"tool": "demos_network_sdk_list_sections", "arguments": {}}

# Get pages in SDK section
{"tool": "demos_network_sdk_get_section_pages", "arguments": {"section": "SDK Reference"}}

# Get code examples
{"tool": "demos_network_sdk_get_code_blocks", "arguments": {"path": "/sdk/examples"}}

# Refresh cached content
{"tool": "demos_network_sdk_refresh_content", "arguments": {}}

人工智能集成

Demos SDK MCP服务器针对AI助手集成进行了优化：

AI何时使用此MCP：

• 关于Demos Network SDK使用的问题
• 多链开发和跨链集成
• Web2到Web3桥接（DAHR）问题
• XM协议实现
• SDK示例和代码片段

领域特定功能：

• 专注于区块链和多链开发
• 包括Demos网络特定术语
• 针对SDK文档和API参考进行了优化

建筑

• GitBookScraper：处理网页抓取、内容提取和降价转换
• ContentStore：管理内容存储和高级搜索功能
• GitBookMCPServer：带有工具处理程序的主MCP服务器实现
• GitBookRestAPI：带有HTTP端点的Express.js REST API服务器
• DomainDetector：自动检测域名品牌和关键字
• TextProcessor：内容处理，包括词干提取和规范化

发展

# Development mode with auto-reload
npm run dev

# Build
npm run build

# Run built version
npm start

运作原理

1. 域检测：分析您的GitBook内容以检测域名和关键字
2. 平行刮擦：使用可配置的并发性高效地抓取所有页面
3. 智能索引：使用词干提取、归一化和模糊搜索处理内容
4. 变化检测：仅重新抓取修改过的页面以获得最佳性能
5. MCP集成：为AI助手提供特定领域的工具和提示

Demos网络SDK支持

此MCP服务器是专门为Demos Network SDK文档配置的，位于 docs.kynesys.xyz:

• SDK文档 -完整的Demos Network SDK参考
• API参考资料 -REST和GraphQL端点
• 开发者指南 -集成教程和示例
• 多链支持 -跨链开发指南
• XM协议 -扩展消息协议文档
• DAHR集成 -Web2到Web3桥接指南

专门用于：

• 区块链和多链开发
• 跨链通信协议
• Web2到Web3集成模式
• Demos网络生态系统工具

局限性

• 仅限公共GitBooks -需要可公开访问的GitBook网站
• 静态内容 -不基于API，抓取已发布的HTML
• 手动刷新 -无实时更新（使用 refresh_content 工具）
• 以文本为中心 -提取文本内容，而不是复杂的交互元素

部署选项

地方发展：

npm run dev  # Development mode with auto-reload

生产MCP服务器：

npm run build && npm start

生产REST API：

npm run build && npm run start:api

Docker（可选）：

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
CMD ["npm", "start"]

Claude桌面集成：

{
  "mcpServers": {
    "demos-sdk": {
      "command": "demosdk-mcp-server"
    }
  }
}

许可证

麻省理工学院