AI导哈

NextMCP文档服务器

一个帮助AI编码助手理解和构建NextMCP服务器的文档服务，提供全面的文档、示例和指南。

  • by KeshavVarad
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 KeshavVarad/nextmcp-docs-server

使用说明

NextMCP文档服务器

一个MCP服务器，帮助编码助手理解并使用NextMCP进行构建

概述

此MCP服务器为使用NextMCP构建MCP服务器提供了全面的文档、示例和指导。它旨在帮助AI编码助手快速理解NextMCP概念并生成正确的代码。

特性

🔧 工具（5）

  • 搜索文档：在NextMCP文档中搜索相关文章
  • get_full_doc：获取特定主题的完整文档
  • 列表_类别：列出所有文档类别
  • get_example_code：获取常见模式的代码示例

📝 提示（3）

  • build_server_prompt：生成构建新MCP服务器的工作流
  • debug_prompt：获取常见问题的调试步骤
  • learn_prompt：为NextMCP主题创建个性化学习路径

📚 资源（3）

  • docs://stats：服务器统计信息和可用文档
  • docs://{doc_id}：通过ID访问特定文档
  • 示例：//{示例名}：访问代码示例作为资源

文件覆盖范围

  • 入门指南：安装、快速入门、基础知识
  • 核心图元：工具、提示、资源
  • 认证：API密钥、JWT、RBAC
  • 中间件：请求/响应拦截器
  • 部署：Docker、云平台、生产设置
  • 例子：常见模式的代码示例

快速开始

地方发展

# Clone repository
git clone https://github.com/KeshavVarad/nextmcp-docs-server.git
cd nextmcp-docs-server

# Install dependencies
pip install -r requirements.txt

# Run server
python app.py

服务器将于启动 http://localhost:8000

码头工人

# Build image
docker build -t nextmcp-docs-server .

# Run container
docker run -p 8000:8000 nextmcp-docs-server

部署到导管

# Prerequisites: Conduit account and project

# Create project in Conduit dashboard
# - Name: NextMCP Docs Server
# - Git URL: https://github.com/KeshavVarad/nextmcp-docs-server
# - Branch: main

# Deploy via dashboard or CLI
conduit deploy

用法示例

搜索文档

# Tool call
search_documentation(query="authentication")

# Returns articles about API keys, JWT, RBAC, etc.

获取示例代码

# Tool call
get_example_code(example_name="simple-tool")

# Returns complete code example with explanation

构建服务器工作流

# Prompt call
build_server_prompt(
    server_type="tool-based",
    features="auth,metrics"
)

# Returns step-by-step guide for building the server

访问文档资源

# Resource URI
docs://deployment

# Returns full deployment documentation

API终点

  • GET /health -健康检查（退货 {"status": "healthy"})
  • POST /mcp -MCP协议端点（JSON-RPC 2.0）

环境变量

  • PORT -服务器端口（默认值：8000）
  • HOST -服务器主机（默认值：0.0.0.0）
  • LOG_LEVEL -日志记录级别（默认值：INFO）

发展

项目结构

nextmcp-docs-server/
├── app.py              # Main server code
├── requirements.txt    # Python dependencies
├── Dockerfile         # Container image definition
└── README.md          # This file

添加文档

要添加新的文档文章，请编辑 DOCS 字典在 app.py:

DOCS["new-topic"] = {
    "title": "New Topic Title",
    "content": "Documentation content...",
    "category": "guide",
    "tags": ["tag1", "tag2"],
}

测试

# Test locally
python app.py

# In another terminal, test with curl
curl http://localhost:8000/health

# Test MCP protocol
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": 1
  }'

用例

适用于AI编码助理

此服务器帮助AI助手：

  • 了解NextMCP架构和模式
  • 生成正确的MCP服务器代码
  • 提供调试指导
  • 访问最新文档
  • 学习最佳实践

面向开发者

  • NextMCP API快速参考
  • 常见模式的示例代码
  • 部署指南
  • 故障排除帮助

贡献

欢迎投稿！要添加文档，请执行以下操作：

  1. 分叉存储库
  2. 将文档添加到 DOCS 词典
  3. 本地测试
  4. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

链接

支持

对于问题或疑问：

  • GitHub问题：https://github.com/KeshavVarad/nextmcp-docs-server/issues
  • 下一篇MCP讨论：https://github.com/KeshavVarad/NextMCP/discussions

相关 MCP