mcp-code-guidance

by JavaPentesters

206 downloads

Not rated

GitHub

Developer Tools

About

这是一个使用 Python 语言从 0 到 1 搭建 MCP server 的代码学习教程

Details

Author: JavaPentesters
Downloads: 206
Categories: Developer Tools

- Provides step‑by‑step tutorials for MCP and A2A protocols
- Includes multiple ready‑to‑run MCP server examples (quickstart, weather, stock)
- Uses Python 3.10+ and the FastMCP library
- Managed with uv for clean project isolation
- Covers the three MCP capabilities: Tool, Resource, and Prompt
- Licensed under MIT for open‑source use

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-code-guidance

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

From the repository

Clone or download the repository, ensure Python 3.10+ and the uv package manager are installed. Then navigate into a specific example directory (e.g., mcp-server-01quickstart) and run uv init, uv venv, source .venv/bin/activate, and uv add "mcp[cli]" httpx to set up the environment. Detailed steps are provided in the README for each example.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-code-guidance": {
            "mcp-code-guidance": {
                "command": "python",
                "args": [
                    "-m",
                    "http.server",
                    "8181"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-code-guidance": {
        "command": "python",
        "args": [
            "-m",
            "http.server",
            "8181"
        ]
    }
}

mcp-code-guidance

介绍

mcp-code-guidance是一个使用 Python 语言从 0 到 1 学习 MCP 与 A2A 协议的教程。 MCP(Model-Context Protocol,)和A2A(Agent-to-Agent)是大模型应用中两个重要的协议,分别侧重于智能体与外部工具的交互以及智能体之间的协作。

MCP 协议是一种用于模型与外部环境交互的协议,它允许模型通过 API 与外部环境进行通信,并获取外部环境的信息。MCP 协议的主要特点是:
+ 标准化: 开发者只需遵循MCP标准，即可快速接入多种AI模型和服务；
+ 安全性: 提供多层次的安全机制，包括数据加密、身份验证和权限控制等；
+ 灵活性: 无论是数据库、文件还是 API，MCP 都能提供支持；
+ 跨平台: MCP 适用于任何系统和编程语言（如Python、TypeScript、Go）

MCP（Model Context Protocol）提供了三种主要能力：Tool、Resource 和 Prompt
+ Tool
通过 Tool，LLM 可以直接调用暴露的函数，从而实现对功能的主动控制。例如，查询数据库、发送消息、调用 API 或执行特定逻辑的任务。
+ Resource
Resource 可用于为 LLM 提供上下文信息，帮助其更好地理解和响应用户需求。
+ Prompt
Prompt 是由服务器定义的可重用指令或者模板，用户可以通过选择提示词来引导或标准化与 LLM 的交互过程，使其更精确和标准化输出。

官方地址: https://modelcontextprotocol.io/introduction

项目结构

mcp-code-guidance/
├── LICENSE
├── README.md
├── README_ZH.md
├── mcp-server-01quickstart # 最简单 MCP 服务只包含 tools
├── mcp-server-02weather # 查询天气 MCP 服务
├── mcp-server-03stock # 查询股票 MCP 服务
├── my-project
└── tutorial #  MCP与A2A 开发教程

环境需要

+ python 3.10+ + FastMCP

安装步骤

1.安装uv
+ 安装 uv 命令

 curl -LsSf https://astral.sh/uv/install.sh | sh

install.sh 脚本执行时从 github.com 下载 uv-aarch64-apple-darwin.tar.gz 文件并解压后再安装。众所周之 github.com 网络不稳定。这里提供一个简单的解决方法，手动下载到install.sh 后，再下载目录启动本地 python http 临时服务用于支持脚本下载文件，同时修改install.sh 脚本中的下载地址为本地服务地址。

python -m http.server 8181

调整后的shell 脚本可以参考: 修改后的uv-install.sh

+ 添加用户本地bin目录到PATH

vi ~/.bash_profile

export PATH="$HOME/.local/bin:$PATH"

source ~/.bash_profile

2.cd mcp-code-guidance 初始化项目，以mcp-server-01quickstart 为例

```shell

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

mcp-code-guidance

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

mcp-code-guidance

介绍

项目结构

环境需要

安装步骤

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

mcp-code-guidance

介绍

项目结构

环境需要

安装步骤

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright