Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -559,6 +559,7 @@ A growing set of community-developed and maintained servers demonstrates various
- **[Agentic Framework](https://github.com/Piotr1215/mcp-agentic-framework)** - Multi-agent collaboration framework enabling AI agents to register, discover each other, exchange asynchronous messages via HTTP transport, and work together on complex tasks with persistent message history.
- **[AgentMode](https://www.agentmode.app)** - Connect to dozens of databases, data warehouses, Github & more, from a single MCP server. Run the Docker image locally, in the cloud, or on-premise.
- **[AI Agent Marketplace Index](https://github.com/AI-Agent-Hub/ai-agent-marketplace-index-mcp)** - MCP server to search more than 5000+ AI agents and tools of various categories from [AI Agent Marketplace Index](http://www.deepnlp.org/store/ai-agent) and monitor traffic of AI Agents.
- **[AI Group Markdown to Word Converter](https://github.com/dongjiang1989/aigroup-mdtoword-mcp)** - Professional Markdown to Word document conversion with advanced features including LaTeX math formulas, table processing, image handling, and 6+ preset templates. Built with TypeScript and supports both STDIO and HTTP transports.
- **[AI Tasks](https://github.com/jbrinkman/valkey-ai-tasks)** - Let the AI manage complex plans with integrated task management and tracking tools. Supports STDIO, SSE and Streamable HTTP transports.
- **[ai-Bible](https://github.com/AdbC99/ai-bible)** - Search the bible reliably and repeatably [ai-Bible Labs](https://ai-bible.com)
- **[Airbnb](https://github.com/openbnb-org/mcp-server-airbnb)** - Provides tools to search Airbnb and get listing details.
Expand Down
46 changes: 46 additions & 0 deletions aigroup-mdtoword-mcp/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# 依赖
node_modules/
package-lock.json
yarn.lock

# 构建输出
dist/
build/
*.tsbuildinfo

# 日志
logs/
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# 环境变量
.env
.env.local
.env.*.local

# 编辑器
.vscode/
.idea/
*.swp
*.swo
*~
.DS_Store

# 测试
coverage/
.nyc_output/

# 临时文件
*.tmp
*.temp
.cache/

# 输出文件
*.docx
output/
test-output/

# Roo配置文件
.roo/
202 changes: 202 additions & 0 deletions aigroup-mdtoword-mcp/FINAL_SUBMISSION_PACKAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
# MCP官方仓库提交包 - 完整指南

## 项目状态验证

✅ **所有质量检查通过**
- 项目构建成功
- 依赖安装完成
- 代码质量验证通过
- MCP协议合规性确认

## 手动提交步骤

### 步骤1: Fork MCP官方仓库

1. 访问 https://github.com/modelcontextprotocol/servers
2. 点击右上角的 "Fork" 按钮
3. 选择您的账户作为目标

### 步骤2: 克隆您Fork的仓库

```bash
git clone https://github.com/YOUR_USERNAME/servers.git
cd servers
```

### 步骤3: 添加项目文件

```bash
# 创建项目目录
mkdir aigroup-mdtoword-mcp

# 复制所有项目文件(排除node_modules和dist)
cp -r /path/to/aigroup-mdtoword-mcp-main/* aigroup-mdtoword-mcp/

# 或者手动复制以下目录和文件:
# - README.md
# - package.json
# - src/
# - examples/
# - tests/
# - docs/
# - LICENSE
# - tsconfig.json
# - .gitignore
```

### 步骤4: 更新主README.md

在 `servers/README.md` 文件的 "🌎 Community Servers" 部分添加:

```markdown
**AI Group Markdown to Word Converter** - Professional Markdown to Word document converter with advanced styling, mathematical formulas, table processing, and comprehensive document layout capabilities.
```

### 步骤5: 提交更改

```bash
git add .
git commit -m "feat: Add AI Group Markdown to Word Converter MCP server"
git push origin main
```

### 步骤6: 创建Pull Request

1. 访问您的Fork仓库: https://github.com/YOUR_USERNAME/servers
2. 点击 "Pull Request" 按钮
3. 选择 base repository: `modelcontextprotocol/servers`
4. 使用以下Pull Request描述:

## Pull Request 描述模板

```markdown
# AI Group Markdown to Word Converter MCP Server

## Overview
Professional-grade MCP server for converting Markdown documents to Microsoft Word format with advanced styling, mathematical formulas, and comprehensive document layout capabilities.

## Key Features
- ✅ Advanced Markdown parsing with CommonMark support
- ✅ Professional document layout with headers/footers
- ✅ Mathematical formula rendering (LaTeX math)
- ✅ Table processing with 12+ preset styles
- ✅ Image embedding and styling
- ✅ Template system with 6+ professional presets
- ✅ Full MCP protocol compliance (STDIO/HTTP)

## Technical Specifications
- **Language**: TypeScript
- **Dependencies**: @modelcontextprotocol/sdk, docx, markdown-it, zod
- **Node.js**: 18.0.0+
- **License**: MIT

## Testing
- Integration tests for MCP protocol
- Unit tests for core functionality
- Cross-platform compatibility verified
- Quality checks passed

## Documentation
- Comprehensive README with MCP standards
- Configuration examples for all major MCP clients
- Usage examples and templates
- Technical documentation

## Why This Belongs in Official Repository
1. **High-Quality Implementation**: Professional-grade code with TypeScript
2. **Broad Utility**: Serves academic, business, and technical domains
3. **MCP Best Practices**: Full protocol compliance and proper tool definitions
4. **Active Maintenance**: Regular updates and community support

## Links
- Repository: https://github.com/aigroup/aigroup-mdtoword-mcp
- Documentation: See included README.md and MCP_SUBMISSION.md
- Examples: See examples/ directory

---

Ready for official MCP repository inclusion! 🚀
```

## 项目文件清单

确保以下文件已包含在提交中:

### 核心文件
- ✅ `README.md` - 主文档
- ✅ `package.json` - 项目配置
- ✅ `src/index.ts` - 主服务器实现
- ✅ `LICENSE` - MIT许可证

### 源代码
- ✅ `src/converter/` - 转换器核心逻辑
- ✅ `src/template/` - 模板系统
- ✅ `src/types/` - 类型定义
- ✅ `src/utils/` - 工具函数

### 文档和示例
- ✅ `examples/` - 使用示例和模板
- ✅ `docs/` - 技术文档
- ✅ `mcp-config-examples.md` - 配置示例
- ✅ `MCP_SUBMISSION.md` - 提交文档
- ✅ `SUBMISSION_GUIDE.md` - 提交指南

### 测试文件
- ✅ `tests/` - 测试文件
- ✅ `quality-check.js` - 质量检查

## 验证提交

提交前请验证:

1. **构建验证**
```bash
cd aigroup-mdtoword-mcp
npm install
npm run build
```

2. **质量检查**
```bash
node quality-check.js
```

3. **功能测试**
```bash
node tests/mcp-integration-test.js
```

## 后续步骤

### 监控Pull Request
- 及时响应审查评论
- 按要求进行修改
- 提供额外信息

### 维护承诺
- 继续积极开发
- 处理问题和bug
- 提供社区支持
- 定期更新和改进

## 联系方式

- **作者**: AI Group
- **邮箱**: [email protected]
- **GitHub**: https://github.com/jackdark425

## 成功标准

项目已满足所有MCP官方仓库收录要求:

- ✅ **技术质量**: 专业级TypeScript实现
- ✅ **MCP合规**: 完整协议支持
- ✅ **文档完整**: 符合MCP标准
- ✅ **测试充分**: 集成和单元测试
- ✅ **社区友好**: MIT许可证和活跃维护

---

**项目已完全准备好提交到MCP官方仓库!** 🎉

*最后更新: 2025-11-24*
21 changes: 21 additions & 0 deletions aigroup-mdtoword-mcp/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2024 AI Group

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Loading