# mcp-server-codelabs

**Repository Path**: gorit/mcp-server-codelabs

## Basic Information

- **Project Name**: mcp-server-codelabs
- **Description**: 手把手教你用 mcp-server 完成各种最佳实践内容

- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Server 最佳实践

本项目是基于 MCP Server 的最佳实践示例，旨在帮助开发者快速上手并理解其核心功能。

## 项目地址

https://gitee.com/gorit/mcp-server-codelabs

## mcp实战
1. 豆瓣top250 图书爬取 (win/mac)
2. 高德地图攻略开发 (mac)

## 项目结构

本项目使用 win 分支和 mac 分支区分不同环境下的 mcp-server 开发，当前主分支为 master

## 常见 MCP Server 地址

### MCP Server 供应商

- [mcp.so](https://mcp.so/explore)
- [mcp-marketplace](https://cline.bot/mcp-marketplace)
- [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)
- [ModelScope MCP 广场](https://modelscope.cn/mcp)
- [阿里云百炼](https://bailian.console.aliyun.com/console?tab=mcp#/mcp-market)
- [腾讯云MCP](https://cloud.tencent.com/developer/mcp)

### MCP Server 资料补充

- [mcp 介绍](https://modelcontextprotocol.io/introduction)
- [excel-mcp-server](https://github.com/negokaz/excel-mcp-server)
- [edgeone-pages-mcp-server](https://mcp.edgeone.site/)
    - 把你本地的 HTML 部署至 EdgeOne 并返回公网可访问的地址
## 一些 mcp 配置
> 其实这些配置都可以在 Github 上找到配置的方式

### vs code
项目根目录 `.vscode/mcp.json`，一般与 Github Copilot 自带的模型交互输出

```json
{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "替换为你的代码路径",
      ]
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--vision"
      ]
    },
    "excel": {
      "command": "npx",
      "args": [
        "--yes",
        "@negokaz/excel-mcp-server"
      ],
      "env": {
        "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
      }
    },
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "替换为你的个人访问token"
      }
    },
    "mcp-server-time": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_time",
        "--local-timezone=Asia/Shanghai"
      ],
      "fromGalleryId": "modelcontextprotocol.servers_git"
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ],
      "fromGalleryId": "modelcontextprotocol.servers_slack"
    },
    "edgeone-pages-mcp-server": {
      "command": "npx",
      "args": [
        "edgeone-pages-mcp"
      ]
    },
    "mcp-server-git": {
      "command": "uvx",
      "args": [
        "mcp-server-git"
      ]
    }
  }
}
```

### Claude code
找到你的 **.claude.json** 配置，win 是在 `C:\Users\你的用户名\.claude.json`，mac 在 `/home/用户名/.claude.json` 下d

```json
.claude.json
{
  // ...
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "替换为你自己的目录即可",
      ],
      "env": {}
    },
    "puppeteer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ],
      "env": {}
    },
    "mcp-fetch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kazuph/mcp-fetch"
      ],
      "env": {}
    },
    "mcp-server-fetch": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ]
    },
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "env": {}
    },
    "thinking": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ],
      "env": {}
    },
    "mcp-server-git": {
      "command": "uvx",
      "args": [
        "mcp-server-git"
      ]
    }
  },
  //...
}
```

## 贡献指南

欢迎提交 Issue 和 Pull Request 来改进本项目。

## 许可证

本项目基于 MIT 许可证开源。