Skip to content

Latest commit

 

History

History
851 lines (681 loc) · 42.7 KB

File metadata and controls

851 lines (681 loc) · 42.7 KB

समुदाय आणि योगदान

MCP मध्ये योगदान कसे करावे: उपकरणे, दस्तऐवज, कोड आणि अधिक

(या धड्याचा व्हिडिओ पाहण्यासाठी वर दिलेल्या प्रतिमावर क्लिक करा)

आढावा

हा धडा MCP समुदायाशी कसे संलग्न व्हायचे, MCP पर्यावरणात कसे योगदान द्यायचे आणि सहकार्यासाठी सर्वोत्तम पद्धती कशा पाळायच्या यावर लक्ष केंद्रित करतो. उघड्या स्रोताच्या MCP प्रकल्पांमध्ये सहभागी होण्याची समज ही या तंत्रज्ञानाच्या भविष्यासाठी फार महत्त्वाची आहे.

शिकण्याच्या उद्दिष्टे

या धड्याच्या शेवटी, तुम्ही खालील गोष्टी करू शकाल:

  • MCP समुदाय आणि पर्यावरणाची रचना समजून घेणे
  • MCP समुदाय मंचांमध्ये आणि चर्चांमध्ये प्रभावीपणे भाग घेणे
  • MCP उघडा-स्रोत रिपॉझिटरीजमध्ये योगदान देणे
  • कस्टम MCP उपकरणे आणि सर्व्हर तयार करणे आणि शेअर करणे
  • MCP विकास आणि सहकार्याच्या सर्वोत्तम पद्धतींचा अवलंब करणे
  • MCP विकासासाठी समुदाय संसाधने आणि फ्रेमवर्क शोधणे

MCP समुदाय पर्यावरण

MCP पर्यावरणामध्ये विविध घटक आणि सहभागी असतात जे प्रोटोकॉलच्या प्रगतीसाठी एकत्र काम करतात.

मुख्य समुदाय घटक

  1. कोर प्रोटोकॉल देखभाल करणारे: अधिकृत Model Context Protocol GitHub संस्था कोर MCP तपशील आणि संदर्भ अंमलबजावणी सांभाळते
  2. उपकरण विकसक: अशी व्यक्ती आणि संघ जे MCP उपकरणे आणि सर्व्हर तयार करतात
  3. संमेलन प्रदाते: ज्या कंपन्या त्यांच्या उत्पादनांमध्ये आणि सेवांमध्ये MCP एकत्रित करतात
  4. अंतिम वापरकर्ते: विकसक आणि संस्था जे त्यांच्या अनुप्रयोगांमध्ये MCP वापरतात
  5. योगदान करणारे: समुदायातील सदस्य जे कोड, दस्तऐवज किंवा इतर संसाधने योगदान देतात

समुदाय संसाधने

अधिकृत चॅनेल्स

समुदाय-चालित संसाधने

  • MCP क्लायंट्स - MCP एकत्रिकरणांना समर्थन देणाऱ्या क्लायंट्सची यादी
  • समुदाय MCP सर्व्हर - समुदाय विकसितकृत MCP सर्व्हर्सची वाढती यादी
  • Awesome MCP सर्व्हर - MCP सर्व्हरची हक्कदार यादी
  • PulseMCP - MCP संसाधने शोधण्यासाठी समुदाय हब आणि न्यूजलेटर
  • डिस्कॉर्ड सर्व्हर - MCP विकसकांशी संपर्क साधा
  • भाषा-विशिष्ट SDK अंमलबजावणी
  • ब्लॉग पोस्ट आणि ट्युटोरियल्स

MCP मध्ये योगदान देणे

योगदानाचे प्रकार

MCP पर्यावरण विविध प्रकारच्या योगदानांचे स्वागत करते:

  1. कोड योगदान:

    • कोर प्रोटोकॉल सुधारणा
    • बग फिक्सेस
    • उपकरणे आणि सर्व्हर अंमलबजावणी
    • वेगवेगळ्या भाषांतील क्लायंट/सर्व्हर लायब्ररी
  2. दस्तऐवजीकरण:

    • विद्यमान दस्तऐवज सुधारणा
    • ट्युटोरियल्स आणि मार्गदर्शक तयार करणे
    • दस्तऐवजांचे भाषांतर करणे
    • उदाहरणे आणि नमुना अनुप्रयोग तयार करणे
  3. समुदाय समर्थन:

    • मंचांवर आणि चर्चांमध्ये प्रश्नांची उत्तरे देणे
    • चाचणी करणे आणि समस्या नोंदविणे
    • समुदाय कार्यक्रमांचे आयोजन करणे
    • नवीन योगदानकर्त्यांना मार्गदर्शन करणे

योगदान प्रक्रिया: कोर प्रोटोकॉल

कोर MCP प्रोटोकॉल किंवा अधिकृत अंमलबजावणीसाठी योगदान देण्यासाठी, अधिकृत योगदान मार्गदर्शिकेतील या तत्त्वांचा अवलंब करा:

  1. सोपेपणा आणि साधेपणा: MCP तपशील नवीन संकल्पना जोडण्यासाठी उच्च मानक राखतो. एखाद्या तपशीलात गोष्टी जोडणे सोपे असले तरी त्यांना काढून टाकणे अधिक अवघड आहे.

  2. ठोस दृष्टिकोन: तपशील बदल विशिष्ट अंमलबजावणीच्या अडचणींवर आधारित असावेत, गृहितकल्पनांवर नाहीत.

  3. प्रस्तावाचे टप्पे:

    • व्याख्या करा: समस्या क्षेत्राचा अभ्यास करा, अन्य MCP वापरकर्त्यांना समान समस्या आहे का तपासा
    • प्रोटोटाइप: उदाहरणात्मक उपाय तयार करा आणि त्याचा व्यावहारिक वापर दाखवा
    • लिहा: प्रोटोटाइपवर आधारित तपशील प्रस्ताव लिहा

विकास पर्यावरण सेटअप

# रिपॉझिटरी फोर्क करा
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
cd modelcontextprotocol

# अवलंबित्व स्थापित करा
npm install

# स्कीमा बदलांसाठी, स्कीमा मान्य करा आणि schema.json तयार करा:
npm run check:schema:ts
npm run generate:schema

# दस्तऐवजीकरण बदलांसाठी
npm run check:docs
npm run format

# दस्तऐवजीकरण स्थानिकरित्या पूर्वदर्शन करा (पर्यायी):
npm run serve:docs

उदाहरण: बग फिक्स योगदान

// टायपस्क्रिप्ट-एसडीकेत मूळ कोडमधील बग
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // बग: प्रॉपर्टी मान्यता गायब
  // सध्याची अंमलबजावणी:
  const hasName = 'name' in resource;
  const hasSchema = 'schema' in resource;
  
  return hasName && hasSchema;
}

// योगदानात दुरुस्त केलेली अंमलबजावणी
export function validateResource(resource: unknown): resource is MCPResource {
  if (!resource || typeof resource !== 'object') {
    return false;
  }
  
  // सुधारित मान्यता
  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;
}

उदाहरण: स्टँडर्ड लायब्ररीसाठी नवीन उपकरण योगदान

# उदाहरण देणगी: MCP स्टँडर्ड लायब्ररीसाठी CSV डेटा प्रक्रिया साधन

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:
            # पॅरामीटर्स मिळवा
            operation = request.parameters.get("operation")
            output_format = request.parameters.get("outputFormat", "json")
            
            # थेट डेटा किंवा URL मधून CSV डेटा मिळवा
            df = await self._get_dataframe(request)
            
            # विनंती केलेल्या ऑपरेशनच्या आधारावर प्रक्रिया करा
            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"""
        # अंमलबजावणीमध्ये विविध रूपांतरे समाविष्ट असतील
        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}")

योगदान मार्गदर्शिका

MCP प्रकल्पांसाठी यशस्वी योगदान करण्यासाठी:

  1. लहानपासून प्रारंभ करा: दस्तऐवज, बग फिक्सेस किंवा लहान सुधारणा करून सुरुवात करा
  2. शैली मार्गदर्शकाचा अवलंब करा: प्रकल्पाच्या कोडिंग शैली आणि परंपरांचे पालन करा
  3. चाचण्या लिहा: तुमच्या कोड योगदानांसाठी युनिट टेस्ट्स जोडा
  4. तुमचे काम दस्तऐवज करा: नवीन वैशिष्ट्ये किंवा बदलांसाठी स्पष्ट दस्तऐवज जोडा
  5. लक्ष केंद्रित PR सबमिट करा: पुल विनंत्या एका मुद्दा किंवा वैशिष्ट्यावर लक्ष केंद्रित ठेवा
  6. अभिप्रायाशी संवाद करा: तुमच्या योगदानावरील अभिप्रायावर प्रतिसाद द्या

उदाहरण योगदान कार्यप्रवाह

# रेपॉझिटरी क्लोन करा
git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk

# आपल्या योगदानासाठी नवीन शाखा तयार करा
git checkout -b feature/my-contribution

# आपले बदल करा
# ...

# आपले बदल विद्यमान कार्यक्षमता बाधित करणार नाहीत याची खात्री करण्यासाठी चाचण्या चालवा
npm test

# वर्णनात्मक संदेशासह आपले बदल कमिट करा
git commit -am "Fix validation in resource handler"

# आपली शाखा आपल्या फोर्कवर पुश करा
git push origin feature/my-contribution

# मुख्य रेपॉझिटरीसाठी आपल्या शाखेतून पुल रिक्वेस्ट तयार करा
# नंतर अभिप्रायावर संवाद साधा आणि आपली PR आवश्यकतेनुसार सुधारित करा

MCP सर्व्हर तयार करणे आणि शेअर करणे

MCP पर्यावरणात योगदान देण्याचा सर्वात मौल्यवान मार्ग म्हणजे कस्टम MCP सर्व्हर तयार करणे आणि ते शेअर करणे. समुदायाने वेगवेगळ्या सेवा आणि वापर प्रकरणांसाठी शेकडो सर्व्हर तयार केले आहेत.

MCP सर्व्हर विकास फ्रेमवर्क

MCP सर्व्हर विकास सुलभ करण्यासाठी काही फ्रेमवर्क उपलब्ध आहेत:

  1. अधिकृत SDKs (MCP Specification 2025-11-25 शी सुसंगत):

  2. समुदाय फ्रेमवर्क:

    • MCP-Framework - TypeScript मध्ये सुंदरता आणि वेगाने MCP सर्व्हर्स तयार करा
    • MCP Declarative Java SDK - Java सह अ‍ॅनोटेशन-चालित MCP सर्व्हर्स
    • Quarkus MCP Server SDK - MCP सर्व्हर्ससाठी Java फ्रेमवर्क
    • Next.js MCP Server Template - MCP सर्व्हरसाठी प्रारंभिक Next.js प्रकल्प

शेअर करण्यायोग्य उपकरणे विकसित करणे

.NET उदाहरण: शेअर करण्यायोग्य उपकरण पॅकेज तयार करणे

// 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

Java उदाहरण: उपकरणांसाठी Maven पॅकेज तयार करणे

// शेअर करण्यायोग्य MCP टूल पॅकेजसाठी pom.xml कॉन्फिगरेशन
<!-- 
<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<>();
        // युक्तीची व्याख्या...
        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;
            
            // हवामान API कॉल करा
            Map<String, Object> forecast = getForecast(location, days);
            
            // प्रतिसाद तयार करा
            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) {
        // अंमलबजावणी हवामान API कॉल करेल
        // साधी उदाहरण
        Map<String, Object> result = new HashMap<>();
        // हवामान अंदाज डेटा जोडा...
        return result;
    }
}

// Maven वापरून तयार करा आणि प्रकाशित करा
// mvn clean package
// mvn deploy

Python उदाहरण: PyPI पॅकेज प्रकाशित करणे

# PyPI पॅकेजसाठी डायरेक्टरी रचना:
# mcp_nlp_tools/
# ├── LICENSE
# ├── README.md
# ├── setup.py
# ├── mcp_nlp_tools/
# │   ├── __init__.py
# │   ├── sentiment_tool.py
# │   └── translation_tool.py

# उदाहरण 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",
)
"""

# उदाहरण NLP टूल अंमलबजावणी (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"):
        # भावना विश्लेषण मॉडेल लोड करा
        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:
            # पॅरामीटर्स काढा
            text = request.parameters.get("text")
            include_score = request.parameters.get("includeScore", True)
            
            # भावना विश्लेषण करा
            sentiment_result = self.sentiment_analyzer(text)[0]
            
            # निकाल फॉरमॅट करा
            result = {
                "sentiment": sentiment_result["label"],
                "text": text
            }
            
            if include_score:
                result["score"] = sentiment_result["score"]
            
            # निकाल परत करा
            return ToolResponse(result=result)
            
        except Exception as e:
            raise ToolExecutionException(f"Sentiment analysis failed: {str(e)}")

# प्रकाशनासाठी:
# python setup.py sdist bdist_wheel
# python -m twine upload dist/*

सर्वोत्तम पद्धती शेअर करणे

जेव्हा MCP उपकरणे समुदायासोबत शेअर करता:

  1. पूर्ण दस्तऐवजीकरण:

    • उद्दिष्ट, वापर आणि उदाहरणे दस्तऐवज करा
    • पॅरामीटर्स आणि परतावा मूल्ये स्पष्ट करा
    • कोणतीही बाह्य अवलंबित्वे दस्तऐवज करा
  2. त्रुटी हाताळणी:

    • मजबूत त्रुटी हाताळणी अंमलात आणा
    • उपयुक्त त्रुटी संदेश द्या
    • कडेकोट बाबी काळजीपूर्वक हाताळा
  3. कामगिरीचा विचार:

    • गती आणि संसाधन वापरासाठी ऑप्टिमाइझ करा
    • योग्य तेथे कॅशिंग वापरा
    • स्केलेबिलिटीचा विचार करा
  4. सुरक्षा:

    • सुरक्षित API की आणि प्रमाणीकरण वापरा
    • इनपुट्सची प्रमाणीकरण आणि स्वच्छता करा
    • बाह्य API कॉलसाठी दर मर्यादा लागू करा
  5. चाचणी:

    • व्यापक चाचणी कव्हरेज जोडा
    • वेगवेगळ्या इनपुट प्रकारांसह आणि कोपऱ्याच्या बाबींवर चाचणी करा
    • चाचणी प्रक्रिया दस्तऐवज करा

समुदाय सहकार्य आणि सर्वोत्तम पद्धती

प्रभावी सहकार्य हा एक ठराविक MCP पर्यावरणासाठी महत्त्वाचा घटक आहे.

संवाद चॅनेल्स

  • GitHub समस्या आणि चर्चा
  • Microsoft टेक समुदाय
  • Discord आणि Slack चॅनेल्स
  • Stack Overflow (टॅग: model-context-protocol किंवा mcp)

कोड पुनरावलोकने

MCP योगदान पुनरावलोकन करताना:

  1. स्वच्छता: कोड स्पष्ट आणि चांगल्या प्रमाणे दस्तऐवज आहे का?
  2. बरोबरी: तो अपेक्षेनुसार काम करतो का?
  3. सुसंगतता: प्रकल्पाच्या परंपरांचे पालन करतो का?
  4. पूर्णता: चाचण्या आणि दस्तऐवज यांचा समावेश आहे का?
  5. सुरक्षा: कोणत्या सुरक्षा समस्यांचा विचार केलेला आहे का?

आवृत्ती सुसंगतता

MCP साठी विकास करताना:

  1. प्रोटोकॉल आवृत्ती: तुमचे उपकरण समर्थित MCP प्रोटोकॉल आवृत्तीचे पालन करा
  2. क्लायंट सुसंगतता: मागील आवृत्त्यांशी सुसंगतता लक्षात घ्या
  3. सर्व्हर सुसंगतता: सर्व्हर अंमलबजावणी मार्गदर्शकांचे पालन करा
  4. ब्रेकिंग बदल: कोणतेही ब्रेकिंग बदल स्पष्टपणे दस्तऐवज करा

उदाहरण समुदाय प्रकल्प: MCP उपकरण नोंदणी

माझ्या समुदाय योगदानांपैकी एक महत्त्वाचा प्रकल्प MCP उपकरणांसाठी सार्वजनिक नोंदणी विकसित करणे असू शकते.

# कम्युनिटी टूल रजिस्ट्री API साठी उदाहरण स्कीमा

from fastapi import FastAPI, HTTPException, Depends
from pydantic import BaseModel, Field, HttpUrl
from typing import List, Optional
import datetime
import uuid

# टूल रजिस्ट्रीसाठी मॉडेल्स
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 अनुप्रयोग
app = FastAPI(title="MCP Tool Registry")

# या उदाहरणासाठी इन-मेमरी डेटाबेस
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"}

मुख्य मुद्दे

  • MCP समुदाय विविधतेने भरलेला असून विविध प्रकारच्या योगदानांचे स्वागत करतो
  • MCP मध्ये योगदान कोर प्रोटोकॉल सुधारणा ते कस्टम उपकरणे तयार करण्यापर्यंत असू शकते
  • योगदान मार्गदर्शिका पाळल्यास आपल्या PR स्वीकारले जाण्याची शक्यता वाढते
  • MCP उपकरणे तयार करणे आणि शेअर करणे पर्यावरण सुधारण्यात मौल्यवान आहे
  • समुदाय सहकार्य MCP च्या वाढी आणि सुधारनेसाठी आवश्यक आहे

व्यायाम

  1. आपल्या कौशल्ये आणि आवडींवर आधारित MCP पर्यावरणातील कोणत्या भागात आपण योगदान देऊ शकता ते ओळखा
  2. MCP रिपॉझिटरी फोर्क करा आणि स्थानिक विकास पर्यावरण सेट करा
  3. समुदायाला फायदेशीर ठरेल अशी लहान सुधारणा, बग फिक्स किंवा उपकरण तयार करा
  4. तुमचे योगदान योग्य चाचण्या आणि दस्तऐवजीकरणासह दस्तऐवज करा
  5. योग्य रिपॉझिटरीमध्ये पुल विनंती सादर करा

अतिरिक्त संसाधने


पुढे काय

पुढे: प्रारंभिक स्वीकारण्यापासून धडे


अस्वीकरण: हा दस्तऐवज AI अनुवाद सेवा Co-op Translator चा वापर करून अनुवादित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्न करतो, तरी कृपया लक्षात घ्या की स्वयंचलित अनुवादामध्ये चुका किंवा अचूकतेचा अभाव असू शकतो. मूळ दस्तऐवज त्याच्या स्थानिक भाषेत अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहिती साठी व्यावसायिक मानवी अनुवाद करण्याची शिफारस केली जाते. या अनुवादाच्या वापरामुळे उद्भवलेल्या कोणत्याही गैरसमजुतीसाठी किंवा चुकीच्या अर्थ लावण्यांसाठी आम्ही जबाबदार नाही.