McpToolServerConfigurationService class
الخدمة المسؤولة عن اكتشاف خوادم أدوات MCP (بروتوكول سياق النموذج) وتطبيعها وإنتاج كائنات التكوين التي يمكن استهلاكها بواسطة Claude SDK.
المنشئون
| Mcp |
إنشاء McpToolServerConfigurationService. |
الأساليب
| get |
الاتصال بخادم MCP وإرجاع الأدوات بأسماء مسبوقة باسم الخادم. يطرح إذا كان عنوان URL للخادم مفقودا أو فشل العميل في سرد الأدوات. |
| list |
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة. |
| list |
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة. |
| list |
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة. يحل هذا التحميل الزائد تلقائيا agenticAppId من TurnContext وينشئ رمز المصادقة إذا لم يتم توفيره. |
| send |
يرسل محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي. |
| send |
يرسل محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي. |
تفاصيل المنشئ
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
إنشاء McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)المعلمات
- configProvider
موفر التكوين الاختياري. الإعدادات الافتراضية ل defaultToolingConfigurationProvider إذا لم يتم تحديدها.
تفاصيل الأسلوب
getMcpClientTools(string, MCPServerConfig)
الاتصال بخادم MCP وإرجاع الأدوات بأسماء مسبوقة باسم الخادم. يطرح إذا كان عنوان URL للخادم مفقودا أو فشل العميل في سرد الأدوات.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>المعلمات
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
المرتجعات
Promise<McpClientTool[]>
listToolServers(string, string)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>المعلمات
- agenticAppId
-
string
معرف التطبيق الوكيل الذي سيتم اكتشاف الخوادم له.
- authToken
-
string
الرمز المميز للحامل المستخدم عند الاستعلام عن بوابة الأدوات البعيدة.
المرتجعات
Promise<MCPServerConfig[]>
وعد بالحل إلى صفيف من كائنات تكوين خادم MCP التي تمت تسويتها.
listToolServers(string, string, ToolOptions)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>المعلمات
- agenticAppId
-
string
معرف التطبيق الوكيل الذي سيتم اكتشاف الخوادم له.
- authToken
-
string
الرمز المميز للحامل المستخدم عند الاستعلام عن بوابة الأدوات البعيدة.
- options
- ToolOptions
خيارات الأداة الاختيارية عند استدعاء البوابة.
المرتجعات
Promise<MCPServerConfig[]>
وعد بالحل إلى صفيف من كائنات تكوين خادم MCP التي تمت تسويتها.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
إرجاع تعريفات خادم MCP للعامل المحدد. في التطوير (NODE_ENV=Development) يقرأ هذا ToolingManifest.jsonالمحلي ؛ وإلا فإنه يستعلم عن بوابة الأدوات البعيدة. يحل هذا التحميل الزائد تلقائيا agenticAppId من TurnContext وينشئ رمز المصادقة إذا لم يتم توفيره.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>المعلمات
- turnContext
- TurnContext
TurnContext للطلب الحالي.
- authorization
- Authorization
كائن التخويل لتبادل الرمز المميز.
- authHandlerName
-
string
اسم معالج المصادقة المراد استخدامه لتبادل الرمز المميز.
- authToken
-
string
رمز حامل اختياري. إذا لم يتم توفيره، فسيتم إنشاؤه تلقائيا عبر تبادل الرمز المميز.
- options
- ToolOptions
خيارات الأداة الاختيارية عند استدعاء البوابة.
المرتجعات
Promise<MCPServerConfig[]>
وعد بالحل إلى صفيف من كائنات تكوين خادم MCP التي تمت تسويتها.
sendChatHistory(TurnContext, ChatHistoryMessage[])
يرسل محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>المعلمات
- turnContext
- TurnContext
سياق الدوران الذي يحتوي على معلومات المحادثة.
- chatHistoryMessages
رسائل محفوظات الدردشة لإرسالها.
المرتجعات
Promise<OperationResult>
وعد يحل إلى OperationResult يشير إلى النجاح أو الفشل.
الملاحظات
يتم التقاط استثناءات HTTP (أخطاء الشبكة والمهلات) وتسجيلها ولكن لا يتم إعادة تكبيرها. بدلا من ذلك، يقوم الأسلوب بإرجاع OperationResult يشير إلى ما إذا كانت العملية قد نجحت أو فشلت. يمكن للمتصلين اختيار فحص النتيجة بحثا عن معالجة الأخطاء أو تجاهلها إذا لم تكن هناك حاجة إلى تفاصيل الخطأ.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
يرسل محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>المعلمات
- turnContext
- TurnContext
سياق الدوران الذي يحتوي على معلومات المحادثة.
- chatHistoryMessages
رسائل محفوظات الدردشة لإرسالها.
- options
- ToolOptions
خيارات الأدوات الاختيارية لإرسال محفوظات الدردشة.
المرتجعات
Promise<OperationResult>
وعد يحل إلى OperationResult يشير إلى النجاح أو الفشل.
الملاحظات
يتم التقاط استثناءات HTTP (أخطاء الشبكة والمهلات) وتسجيلها ولكن لا يتم إعادة تكبيرها. بدلا من ذلك، يقوم الأسلوب بإرجاع OperationResult يشير إلى ما إذا كانت العملية قد نجحت أو فشلت. يمكن للمتصلين اختيار فحص النتيجة بحثا عن معالجة الأخطاء أو تجاهلها إذا لم تكن هناك حاجة إلى تفاصيل الخطأ.