Mcp Base

MCP Base - 模型上下文协议目录

MCP Base 是一个由社区驱动的 Web 平台，专注于模型上下文协议（MCP）生态系统。该平台是用于发现、分享和整理 MCP 服务与客户端的中央目录。

功能

MCP 服务与客户端目录

• 全面的 MCP 服务和客户端集合
• 按类别筛选和搜索
• 按 GitHub 星标数排序
• AI 驱动的分析和描述

智能分类

• 60 多个专业类别
• AI 模型集成、上下文管理、Agent 框架
• 知识管理、开发者工具、安全解决方案
• 特定行业和技术领域

现代 Web 技术

• Next.js 14 App Router
• 使用 TypeScript 实现类型安全
• 使用 Tailwind CSS 打造现代设计
• 响应式且适配移动设备

博客与内容管理

• MCP 相关文章
• 支持 Markdown 的内容编辑器
• SEO 优化
• 自动计算阅读时长

安全的数据库管理

• Supabase PostgreSQL
• 行级安全（RLS）
• 实时更新
• 自动备份

项目结构

mcp-base/
├── app/                     # Next.js App Router
│   ├── (legal)/            # Legal pages (privacy, terms)
│   ├── blog/               # Blog pages and slug routing
│   ├── clients/            # MCP client directory
│   ├── servers/            # MCP server directory
│   ├── globals.css         # Global styles
│   ├── layout.tsx          # Root layout
│   ├── page.tsx            # Homepage
│   └── providers.tsx       # Context providers
├── backend/                # Backend logic
│   ├── queries/            # Supabase queries
│   │   ├── blog.ts         # Blog CRUD operations
│   │   ├── clients.ts      # Client data
│   │   └── servers.ts      # Server data
│   ├── sql/                # Database schema
│   ├── supabase/           # Supabase configuration
│   └── types/              # TypeScript type definitions
├── components/             # React components
│   ├── core/               # Core application components
│   ├── layout/             # Layout components
│   ├── magicui/            # Custom UI components
│   └── ui/                 # Shadcn/ui components
├── data/                   # Static data files
│   ├── categories.ts       # Category definitions
│   └── faqs.ts             # FAQ data
└── helpers/                # Helper functions
    └── estimateReadingTime.ts

安装

先决条件

• Node.js 18+
• npm 或 yarn
• Supabase 账户

1. 克隆仓库

git clone https://github.com/berkayderin/mcp-base.git
cd mcp-base

2. 安装依赖

npm install
# or
yarn install

3. 设置环境变量

创建一个 .env.local 文件：

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. 设置数据库

# Run the SQL files in backend/sql/ in Supabase SQL editor
# 1. 001-repo.sql - Main table structure
# 2. 002-blog.sql - Blog tables

5. 启动开发服务器

npm run dev
# or
yarn dev

在浏览器中打开 http://localhost:3000。

数据库架构

主表

servers 表

- id (bigint): GitHub repo ID
- name (text): Repository name
- full_name (text): Full repository name (owner/repo)
- html_url (text): GitHub URL
- description (text): Description
- language (text): Programming language
- stars (integer): Star count
- categories (text[]): Category array
- ai_analysis (text): AI analysis
- slug (text): URL slug
- is_active (boolean): Active status

clients 表

• 与 servers 表结构相同
• 专用于 MCP 客户端

blog_posts 表

- id (string): UUID
- title (text): Article title
- description (text): Short description
- content (text): Markdown content
- keywords (text[]): Keywords
- slug (text): URL slug
- created_date (timestamp): Creation date

核心功能

搜索与筛选

• 文本搜索：搜索名称、描述、语言和 AI 分析
• 类别筛选：按 60 多个类别筛选
• 分页：经过性能优化的页面导航
• 排序：按星标数自动排序

API 端点

// Server queries
getTopServers(limit: number)
getServersWithPagination(page, pageSize, category)
searchServers(searchQuery, page, pageSize, category)
getServerById(slug)

// Client queries
getTopClients(limit: number)
getClientsWithPagination(page, pageSize, category)
searchClients(searchQuery, page, pageSize, category)
getClientById(slug)

// Blog operations
getAllBlogPosts()
getBlogPostBySlug(slug)

类别系统

内容按 60 多个专业类别整理：

• AI/ML：模型集成、上下文管理、Agent 框架
• 知识管理：知识库、向量数据库、RAG 系统
• 开发者工具：CLI 工具、代码生成、API 框架
• 安全：安全与隐私、AI 安全、合规性
• 行业：企业、医疗保健、金融服务

UI/UX 功能

设计系统

• Shadcn/ui：现代组件库
• Tailwind CSS：实用优先的 CSS 框架
• Radix UI：无障碍基础组件
• Lucide Icons：统一的图标系统

响应式设计

• 移动优先的方法
• 针对平板电脑和桌面设备进行优化
• 支持深色/浅色模式
• 无障碍标准

性能

• Next.js App Router 优化
• 图像优化
• 代码拆分
• 静态生成（SSG）

开发脚本

# Development server
npm run dev

# Production build
npm run build

# Production start
npm run start

# Linting
npm run lint

# Code formatting
npm run format

# Format check
npm run format:check

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 将分支推送到远程仓库（git push origin feature/amazing-feature）
5. 创建 Pull Request

添加 MCP 服务/客户端

• 创建 GitHub issue
• 分享仓库信息
• 说明你建议的类别
• 等待社区审核流程

链接

• 网站：model-context-protocol.com
• GitHub：github.com/berkayderin/mcp-base
• 问题反馈：GitHub Issues
• 讨论：GitHub Discussions

致谢

• Anthropic - MCP 协议开发
• Next.js - React 框架
• Supabase - 后端基础设施
• Tailwind CSS - CSS 框架
• MCP 社区 - 持续贡献与反馈

---

注意：此项目由社区驱动，与 Anthropic 没有官方关联。有关 MCP 协议的更多信息，请访问 Anthropic 官方文档。