(Klikněte na obrázek výše pro zhlédnutí videa této lekce)
Tato lekce se zaměřuje na to, jak se zapojit do komunity MCP, přispívat do ekosystému MCP a dodržovat osvědčené postupy pro kolektivní vývoj. Porozumění tomu, jak se účastnit open-source projektů MCP, je nezbytné pro ty, kteří chtějí formovat budoucnost této technologie.
Na konci této lekce budete schopni:
- Porozumět struktuře komunity a ekosystému MCP
- Efektivně se účastnit diskuzí a fór komunity MCP
- Přispívat do open-source repozitářů MCP
- Vytvářet a sdílet vlastní nástroje a servery MCP
- Dodržovat osvědčené postupy pro vývoj a spolupráci v MCP
- Objevit komunitní zdroje a frameworky pro vývoj MCP
Ekosystém MCP se skládá z různých komponent a účastníků, kteří společně posouvají protokol vpřed.
- Správci jádra protokolu: Oficiální Model Context Protocol GitHub organizace spravuje základní specifikace MCP a referenční implementace
- Vývojáři nástrojů: Jednotlivci a týmy, které vytvářejí nástroje a servery MCP
- Poskytovatelé integrací: Společnosti, které integrují MCP do svých produktů a služeb
- Koncoví uživatelé: Vývojáři a organizace, které MCP používají ve svých aplikacích
- Přispěvatelé: Členové komunity, kteří přispívají kódem, dokumentací či jinými zdroji
- MCP GitHub organizace
- MCP dokumentace
- Specifikace MCP
- GitHub Diskuze
- Repozitář příkladů a serverů MCP
- MCP Klienti - seznam klientů podporujících integrace MCP
- Komunitní MCP servery - rostoucí seznam komunitou vyvinutých MCP serverů
- Awesome MCP Servers - kurátorský seznam MCP serverů
- PulseMCP - komunitní centrum & newsletter pro objevování zdrojů MCP
- Discord server - spojte se s vývojáři MCP
- Implementace SDK specifické pro jazyky
- Blogy a návody
Ekosystém MCP vítá různé typy příspěvků:
-
Příspěvky kódu:
- Vylepšení jádra protokolu
- Opravy chyb
- Implementace nástrojů a serverů
- Knihovny klient/server v různých jazycích
-
Dokumentace:
- Zlepšování stávající dokumentace
- Vytváření tutoriálů a průvodců
- Překlady dokumentace
- Vytváření příkladů a vzorových aplikací
-
Podpora komunity:
- Odpovídání na dotazy ve fórech a diskuzích
- Testování a hlášení problémů
- Organizování komunitních akcí
- Mentorování nových přispěvatelů
Pro přispívání do základního protokolu MCP nebo oficiálních implementací dodržujte principy z oficiálních pravidel přispívání:
-
Jednoduchost a minimalismus: Specifikace MCP klade vysoké nároky na přidávání nových konceptů. Snazší je přidávat věci do specifikace než je odstraňovat.
-
Konkrétní přístup: Změny specifikace by měly být založeny na konkrétních implementačních problémech, ne spekulativních nápadech.
-
Fáze návrhu:
- Definovat: Prozkoumat problém, ověřit, že i jiní uživatelé MCP mají podobný problém
- Prototypovat: Vytvořit příklad řešení a předvést jeho praktickou aplikaci
- Psát: Na základě prototypu napsat návrh specifikace
# Vytvořit fork repozitáře
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
cd modelcontextprotocol
# Nainstalovat závislosti
npm install
# Pro změny v schématu ověřte a vygenerujte schema.json:
npm run check:schema:ts
npm run generate:schema
# Pro změny v dokumentaci
npm run check:docs
npm run format
# Lokálně náhlednout dokumentaci (volitelné):
npm run serve:docs// Původní kód s chybou v typescript-sdk
export function validateResource(resource: unknown): resource is MCPResource {
if (!resource || typeof resource !== 'object') {
return false;
}
// Chyba: Chybějící ověření vlastnosti
// Současná implementace:
const hasName = 'name' in resource;
const hasSchema = 'schema' in resource;
return hasName && hasSchema;
}
// Opravená implementace v příspěvku
export function validateResource(resource: unknown): resource is MCPResource {
if (!resource || typeof resource !== 'object') {
return false;
}
// Vylepšené ověření
const hasName = 'name' in resource && typeof (resource as MCPResource).name === 'string';
const hasSchema = 'schema' in resource && typeof (resource as MCPResource).schema === 'object';
const hasDescription = !('description' in resource) || typeof (resource as MCPResource).description === 'string';
return hasName && hasSchema && hasDescription;
}# Příklad příspěvku: Nástroj pro zpracování CSV dat pro standardní knihovnu MCP
from mcp_tools import Tool, ToolRequest, ToolResponse, ToolExecutionException
import pandas as pd
import io
import json
from typing import Dict, Any, List, Optional
class CsvProcessingTool(Tool):
"""
Tool for processing and analyzing CSV data.
This tool allows models to extract information from CSV files,
run basic analysis, and convert data between formats.
"""
def get_name(self):
return "csvProcessor"
def get_description(self):
return "Processes and analyzes CSV data"
def get_schema(self):
return {
"type": "object",
"properties": {
"csvData": {
"type": "string",
"description": "CSV data as a string"
},
"csvUrl": {
"type": "string",
"description": "URL to a CSV file (alternative to csvData)"
},
"operation": {
"type": "string",
"enum": ["summary", "filter", "transform", "convert"],
"description": "Operation to perform on the CSV data"
},
"filterColumn": {
"type": "string",
"description": "Column to filter by (for filter operation)"
},
"filterValue": {
"type": "string",
"description": "Value to filter for (for filter operation)"
},
"outputFormat": {
"type": "string",
"enum": ["json", "csv", "markdown"],
"default": "json",
"description": "Output format for the processed data"
}
},
"oneOf": [
{"required": ["csvData", "operation"]},
{"required": ["csvUrl", "operation"]}
]
}
async def execute_async(self, request: ToolRequest) -> ToolResponse:
try:
# Extrahujte parametry
operation = request.parameters.get("operation")
output_format = request.parameters.get("outputFormat", "json")
# Získejte CSV data buď z přímých dat, nebo z URL
df = await self._get_dataframe(request)
# Zpracujte na základě požadované operace
result = {}
if operation == "summary":
result = self._generate_summary(df)
elif operation == "filter":
column = request.parameters.get("filterColumn")
value = request.parameters.get("filterValue")
if not column:
raise ToolExecutionException("filterColumn is required for filter operation")
result = self._filter_data(df, column, value)
elif operation == "transform":
result = self._transform_data(df, request.parameters)
elif operation == "convert":
result = self._convert_format(df, output_format)
else:
raise ToolExecutionException(f"Unknown operation: {operation}")
return ToolResponse(result=result)
except Exception as e:
raise ToolExecutionException(f"CSV processing failed: {str(e)}")
async def _get_dataframe(self, request: ToolRequest) -> pd.DataFrame:
"""Gets a pandas DataFrame from either CSV data or URL"""
if "csvData" in request.parameters:
csv_data = request.parameters.get("csvData")
return pd.read_csv(io.StringIO(csv_data))
elif "csvUrl" in request.parameters:
csv_url = request.parameters.get("csvUrl")
return pd.read_csv(csv_url)
else:
raise ToolExecutionException("Either csvData or csvUrl must be provided")
def _generate_summary(self, df: pd.DataFrame) -> Dict[str, Any]:
"""Generates a summary of the CSV data"""
return {
"columns": df.columns.tolist(),
"rowCount": len(df),
"columnCount": len(df.columns),
"numericColumns": df.select_dtypes(include=['number']).columns.tolist(),
"categoricalColumns": df.select_dtypes(include=['object']).columns.tolist(),
"sampleRows": json.loads(df.head(5).to_json(orient="records")),
"statistics": json.loads(df.describe().to_json())
}
def _filter_data(self, df: pd.DataFrame, column: str, value: str) -> Dict[str, Any]:
"""Filters the DataFrame by a column value"""
if column not in df.columns:
raise ToolExecutionException(f"Column '{column}' not found")
filtered_df = df[df[column].astype(str).str.contains(value)]
return {
"originalRowCount": len(df),
"filteredRowCount": len(filtered_df),
"data": json.loads(filtered_df.to_json(orient="records"))
}
def _transform_data(self, df: pd.DataFrame, params: Dict[str, Any]) -> Dict[str, Any]:
"""Transforms the data based on parameters"""
# Implementace by zahrnovala různé transformace
return {
"status": "success",
"message": "Transformation applied"
}
def _convert_format(self, df: pd.DataFrame, format: str) -> Dict[str, Any]:
"""Converts the DataFrame to different formats"""
if format == "json":
return {
"data": json.loads(df.to_json(orient="records")),
"format": "json"
}
elif format == "csv":
return {
"data": df.to_csv(index=False),
"format": "csv"
}
elif format == "markdown":
return {
"data": df.to_markdown(),
"format": "markdown"
}
else:
raise ToolExecutionException(f"Unsupported output format: {format}")Pro úspěšné přispění do projektů MCP:
- Začněte malým: Začněte dokumentací, opravami chyb nebo malými vylepšeními
- Dodržujte stylové směrnice: Dodržujte kódovací styl a konvence projektu
- Pište testy: Zařaďte jednotkové testy pro své kódové příspěvky
- Dokumentujte svou práci: Přidejte jasnou dokumentaci k novým funkcím nebo změnám
- Podávejte cílené PR: Udržujte pull requesty zaměřené na jediný problém nebo funkci
- Reagujte na zpětnou vazbu: Buďte otevření a odpovídejte na připomínky k vašim příspěvkům
# Klonujte repozitář
git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk
# Vytvořte novou větev pro váš příspěvek
git checkout -b feature/my-contribution
# Proveďte své změny
# ...
# Spusťte testy, abyste zajistili, že vaše změny neporuší stávající funkčnost
npm test
# Uložte své změny s popisnou zprávou
git commit -am "Fix validation in resource handler"
# Nahrajte svou větev do vašeho forku
git push origin feature/my-contribution
# Vytvořte pull request ze své větve do hlavního repozitáře
# Poté se zapojte do zpětné vazby a vylepšujte svůj PR podle potřebyJedním z nejhodnotnějších způsobů, jak přispět do ekosystému MCP, je vytvářet a sdílet vlastní MCP servery. Komunita již vyvinula stovky serverů pro různé služby a případy použití.
K dispozici je několik frameworků, které usnadňují vývoj MCP serverů:
-
Oficiální SDK (v souladu s specifikací MCP 2025-11-25):
-
Komunitní frameworky:
- MCP-Framework - Stavte MCP servery elegantně a rychle v TypeScriptu
- MCP Deklarativní Java SDK - Anotačně řízené MCP servery s Javou
- Quarkus MCP Server SDK - Java framework pro MCP servery
- Next.js MCP Server Template - Startovací projekt Next.js pro MCP servery
// Create a new .NET library project
// dotnet new classlib -n McpFinanceTools
using Microsoft.Mcp.Tools;
using System.Threading.Tasks;
using System.Net.Http;
using System.Text.Json;
namespace McpFinanceTools
{
// Stock quote tool
public class StockQuoteTool : IMcpTool
{
private readonly HttpClient _httpClient;
public StockQuoteTool(HttpClient httpClient = null)
{
_httpClient = httpClient ?? new HttpClient();
}
public string Name => "stockQuote";
public string Description => "Gets current stock quotes for specified symbols";
public object GetSchema()
{
return new {
type = "object",
properties = new {
symbol = new {
type = "string",
description = "Stock symbol (e.g., MSFT, AAPL)"
},
includeHistory = new {
type = "boolean",
description = "Whether to include historical data",
default = false
}
},
required = new[] { "symbol" }
};
}
public async Task<ToolResponse> ExecuteAsync(ToolRequest request)
{
// Extract parameters
string symbol = request.Parameters.GetProperty("symbol").GetString();
bool includeHistory = false;
if (request.Parameters.TryGetProperty("includeHistory", out var historyProp))
{
includeHistory = historyProp.GetBoolean();
}
// Call external API (example)
var quoteResult = await GetStockQuoteAsync(symbol);
// Add historical data if requested
if (includeHistory)
{
var historyData = await GetStockHistoryAsync(symbol);
quoteResult.Add("history", historyData);
}
// Return formatted result
return new ToolResponse {
Result = JsonSerializer.SerializeToElement(quoteResult)
};
}
private async Task<Dictionary<string, object>> GetStockQuoteAsync(string symbol)
{
// Implementation would call a real stock API
// This is a simplified example
return new Dictionary<string, object>
{
["symbol"] = symbol,
["price"] = 123.45,
["change"] = 2.5,
["percentChange"] = 1.2,
["lastUpdated"] = DateTime.UtcNow
};
}
private async Task<object> GetStockHistoryAsync(string symbol)
{
// Implementation would get historical data
// Simplified example
return new[]
{
new { date = DateTime.Now.AddDays(-7).Date, price = 120.25 },
new { date = DateTime.Now.AddDays(-6).Date, price = 122.50 },
new { date = DateTime.Now.AddDays(-5).Date, price = 121.75 }
// More historical data...
};
}
}
}
// Create package and publish to NuGet
// dotnet pack -c Release
// dotnet nuget push bin/Release/McpFinanceTools.1.0.0.nupkg -s https://api.nuget.org/v3/index.json -k YOUR_API_KEY// Konfigurace pom.xml pro sdílitelný balíček nástrojů MCP
<!--
<project>
<groupId>com.example</groupId>
<artifactId>mcp-weather-tools</artifactId>
<version>1.0.0</version>
<dependencies>
<dependency>
<groupId>com.mcp</groupId>
<artifactId>mcp-server</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
<distributionManagement>
<repository>
<id>github</id>
<name>GitHub Packages</name>
<url>https://maven.pkg.github.com/username/mcp-weather-tools</url>
</repository>
</distributionManagement>
</project>
-->
package com.example.mcp.weather;
import com.mcp.tools.Tool;
import com.mcp.tools.ToolRequest;
import com.mcp.tools.ToolResponse;
import com.mcp.tools.ToolExecutionException;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.util.HashMap;
import java.util.Map;
public class WeatherForecastTool implements Tool {
private final HttpClient httpClient;
private final String apiKey;
public WeatherForecastTool(String apiKey) {
this.httpClient = HttpClient.newHttpClient();
this.apiKey = apiKey;
}
@Override
public String getName() {
return "weatherForecast";
}
@Override
public String getDescription() {
return "Gets weather forecast for a specified location";
}
@Override
public Object getSchema() {
Map<String, Object> schema = new HashMap<>();
// Definice schématu...
return schema;
}
@Override
public ToolResponse execute(ToolRequest request) {
try {
String location = request.getParameters().get("location").asText();
int days = request.getParameters().has("days") ?
request.getParameters().get("days").asInt() : 3;
// Zavolejte API pro počasí
Map<String, Object> forecast = getForecast(location, days);
// Sestavte odpověď
return new ToolResponse.Builder()
.setResult(forecast)
.build();
} catch (Exception ex) {
throw new ToolExecutionException("Weather forecast failed: " + ex.getMessage(), ex);
}
}
private Map<String, Object> getForecast(String location, int days) {
// Implementace by zavolala API pro počasí
// Zjednodušený příklad
Map<String, Object> result = new HashMap<>();
// Přidat data předpovědi...
return result;
}
}
// Sestavit a publikovat pomocí Maven
// mvn clean package
// mvn deploy# Struktura adresářů pro balíček PyPI:
# mcp_nlp_tools/
# ├── LICENSE
# ├── README.md
# ├── setup.py
# ├── mcp_nlp_tools/
# │ ├── __init__.py
# │ ├── sentiment_tool.py
# │ └── translation_tool.py
# Příklad setup.py
"""
from setuptools import setup, find_packages
setup(
name="mcp_nlp_tools",
version="0.1.0",
packages=find_packages(),
install_requires=[
"mcp_server>=1.0.0",
"transformers>=4.0.0",
"torch>=1.8.0"
],
author="Your Name",
author_email="your.email@example.com",
description="MCP tools for natural language processing tasks",
long_description=open("README.md").read(),
long_description_content_type="text/markdown",
url="https://github.com/username/mcp_nlp_tools",
classifiers=[
"Programming Language :: Python :: 3",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
],
python_requires=">=3.8",
)
"""
# Příklad implementace NLP nástroje (sentiment_tool.py)
from mcp_tools import Tool, ToolRequest, ToolResponse, ToolExecutionException
from transformers import pipeline
import torch
class SentimentAnalysisTool(Tool):
"""MCP tool for sentiment analysis of text"""
def __init__(self, model_name="distilbert-base-uncased-finetuned-sst-2-english"):
# Načíst model pro analýzu sentimentu
self.sentiment_analyzer = pipeline("sentiment-analysis", model=model_name)
def get_name(self):
return "sentimentAnalysis"
def get_description(self):
return "Analyzes the sentiment of text, classifying it as positive or negative"
def get_schema(self):
return {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The text to analyze for sentiment"
},
"includeScore": {
"type": "boolean",
"description": "Whether to include confidence scores",
"default": True
}
},
"required": ["text"]
}
async def execute_async(self, request: ToolRequest) -> ToolResponse:
try:
# Extrahovat parametry
text = request.parameters.get("text")
include_score = request.parameters.get("includeScore", True)
# Analyzovat sentiment
sentiment_result = self.sentiment_analyzer(text)[0]
# Naformátovat výsledek
result = {
"sentiment": sentiment_result["label"],
"text": text
}
if include_score:
result["score"] = sentiment_result["score"]
# Vrátit výsledek
return ToolResponse(result=result)
except Exception as e:
raise ToolExecutionException(f"Sentiment analysis failed: {str(e)}")
# Pro zveřejnění:
# python setup.py sdist bdist_wheel
# python -m twine upload dist/*Při sdílení MCP nástrojů s komunitou:
-
Kompletní dokumentace:
- Dokumentujte účel, použití a příklady
- Vysvětlete parametry a návratové hodnoty
- Dokumentujte závislosti na externích knihovnách
-
Zpracování chyb:
- Implementujte robustní zpracování chyb
- Poskytujte užitečné chybové hlášky
- Ošetřete okrajové případy elegantně
-
Výkonové úvahy:
- Optimalizujte jak rychlost, tak využití zdrojů
- Používejte cache, kde je to vhodné
- Zvažte škálovatelnost
-
Bezpečnost:
- Používejte zabezpečené API klíče a autentizaci
- Validujte a sanitizujte vstupy
- Implementujte omezení rychlosti volání externích API
-
Testování:
- Zařaďte komplexní pokrytí testy
- Testujte s různými typy vstupů a okrajovými případy
- Dokumentujte testovací postupy
Efektivní spolupráce je klíčem k prosperujícímu ekosystému MCP.
- GitHub Issues a Diskuze
- Microsoft Tech Community
- Kanály Discord a Slack
- Stack Overflow (tag:
model-context-protocolnebomcp)
Při revizi příspěvků do MCP:
- Srozumitelnost: Je kód jasný a dobře zdokumentovaný?
- Správnost: Funguje podle očekávání?
- Konzistence: Dodržuje konvence projektu?
- Úplnost: Jsou zahrnuty testy a dokumentace?
- Bezpečnost: Nejsou zde bezpečnostní problémy?
Při vývoji pro MCP:
- Verzování protokolu: Dodržujte verzi protokolu MCP, kterou váš nástroj podporuje
- Kompatibilita klientů: Zvažujte zpětnou kompatibilitu
- Kompatibilita serverů: Řiďte se pokyny pro implementaci serveru
- Narušující změny: Jasně dokumentujte jakékoli nekompatibilní změny
Důležitým příspěvkem komunity může být vývoj veřejného registru nástrojů MCP.
# Příklad schématu pro API komunitního registru nástrojů
from fastapi import FastAPI, HTTPException, Depends
from pydantic import BaseModel, Field, HttpUrl
from typing import List, Optional
import datetime
import uuid
# Modely pro registr nástrojů
class ToolSchema(BaseModel):
"""JSON Schema for a tool"""
type: str
properties: dict
required: List[str] = []
class ToolRegistration(BaseModel):
"""Information for registering a tool"""
name: str = Field(..., description="Unique name for the tool")
description: str = Field(..., description="Description of what the tool does")
version: str = Field(..., description="Semantic version of the tool")
schema: ToolSchema = Field(..., description="JSON Schema for tool parameters")
author: str = Field(..., description="Author of the tool")
repository: Optional[HttpUrl] = Field(None, description="Repository URL")
documentation: Optional[HttpUrl] = Field(None, description="Documentation URL")
package: Optional[HttpUrl] = Field(None, description="Package URL")
tags: List[str] = Field(default_factory=list, description="Tags for categorization")
examples: List[dict] = Field(default_factory=list, description="Example usage")
class Tool(ToolRegistration):
"""Tool with registry metadata"""
id: uuid.UUID = Field(default_factory=uuid.uuid4)
created_at: datetime.datetime = Field(default_factory=datetime.datetime.now)
updated_at: datetime.datetime = Field(default_factory=datetime.datetime.now)
downloads: int = Field(default=0)
rating: float = Field(default=0.0)
ratings_count: int = Field(default=0)
# FastAPI aplikace pro registr
app = FastAPI(title="MCP Tool Registry")
# Paměťová databáze pro tento příklad
tools_db = {}
@app.post("/tools", response_model=Tool)
async def register_tool(tool: ToolRegistration):
"""Register a new tool in the registry"""
if tool.name in tools_db:
raise HTTPException(status_code=400, detail=f"Tool '{tool.name}' already exists")
new_tool = Tool(**tool.dict())
tools_db[tool.name] = new_tool
return new_tool
@app.get("/tools", response_model=List[Tool])
async def list_tools(tag: Optional[str] = None):
"""List all registered tools, optionally filtered by tag"""
if tag:
return [tool for tool in tools_db.values() if tag in tool.tags]
return list(tools_db.values())
@app.get("/tools/{tool_name}", response_model=Tool)
async def get_tool(tool_name: str):
"""Get information about a specific tool"""
if tool_name not in tools_db:
raise HTTPException(status_code=404, detail=f"Tool '{tool_name}' not found")
return tools_db[tool_name]
@app.delete("/tools/{tool_name}")
async def delete_tool(tool_name: str):
"""Delete a tool from the registry"""
if tool_name not in tools_db:
raise HTTPException(status_code=404, detail=f"Tool '{tool_name}' not found")
del tools_db[tool_name]
return {"message": f"Tool '{tool_name}' deleted"}- Komunita MCP je rozmanitá a vítá různé typy příspěvků
- Přispívání do MCP může zahrnovat jak vylepšení jádra protokolu, tak vlastní nástroje
- Dodržování pravidel přispívání zvyšuje šance na akceptaci vašeho PR
- Vytváření a sdílení nástrojů MCP je cenný způsob, jak obohatit ekosystém
- Spolupráce v komunitě je nezbytná pro růst a zlepšení MCP
- Identifikujte oblast v ekosystému MCP, kde byste mohli přispět na základě svých dovedností a zájmů
- Vytvořte fork repozitáře MCP a nastavte si lokální vývojové prostředí
- Vytvořte malé vylepšení, opravu chyby nebo nástroj, který by komunitě prospěl
- Dokumentujte svůj příspěvek s vhodnými testy a dokumentací
- Odešlete pull request do příslušného repozitáře
Dále: Lekce z raného přijetí
Upozornění:
Tento dokument byl přeložen pomocí AI překladatelské služby Co-op Translator. Přestože se snažíme o přesnost, mějte na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Originální dokument v jeho původním jazyce by měl být považován za autoritativní zdroj. Pro důležité informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za žádná nedorozumění nebo chybné výklady vzniklé použitím tohoto překladu.
