From 2e1e20645f682c06688deb4148e18d19823d2ee9 Mon Sep 17 00:00:00 2001 From: Eirik Tsarpalis Date: Wed, 19 Mar 2025 17:27:18 +0200 Subject: [PATCH] Add Directory.Build.props, apply CPM, use NB.GitVersioning, update package publishing --- Directory.Build.props | 17 ++ Directory.Packages.props | 36 ++++ ModelContextProtocol.sln | 6 + logo.png | Bin 0 -> 18307 bytes .../AspNetCoreSseServer.csproj | 2 +- .../TestServerWithHosting.csproj | 10 +- .../ToolsConsole/AnthropicToolsConsole.csproj | 4 +- .../ToolsConsole/MEAIToolsConsole.csproj | 6 +- src/Directory.Build.props | 25 +++ .../ModelContextProtocol.csproj | 47 ++--- src/ModelContextProtocol/README.md | 177 ++++++++++++++++++ .../ModelContextProtocol.TestServer.csproj | 8 +- .../ModelContextProtocol.TestSseServer.csproj | 6 +- .../ModelContextProtocol.Tests.csproj | 20 +- version.json | 9 + 15 files changed, 313 insertions(+), 60 deletions(-) create mode 100644 Directory.Build.props create mode 100644 Directory.Packages.props create mode 100644 logo.png create mode 100644 src/Directory.Build.props create mode 100644 src/ModelContextProtocol/README.md create mode 100644 version.json diff --git a/Directory.Build.props b/Directory.Build.props new file mode 100644 index 00000000..a2ef2565 --- /dev/null +++ b/Directory.Build.props @@ -0,0 +1,17 @@ + + + 13 + true + enable + enable + false + $([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)')) + trx%3bLogFileName=$(MSBuildProjectName).$(TargetFramework).$(OS).trx + $(RepoRoot)/artifacts/TestResults + false + + + + true + + \ No newline at end of file diff --git a/Directory.Packages.props b/Directory.Packages.props new file mode 100644 index 00000000..b57c38b3 --- /dev/null +++ b/Directory.Packages.props @@ -0,0 +1,36 @@ + + + true + 9.3.0-preview.1.25161.3 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/ModelContextProtocol.sln b/ModelContextProtocol.sln index 16a1c4ef..8bd8f627 100644 --- a/ModelContextProtocol.sln +++ b/ModelContextProtocol.sln @@ -24,12 +24,18 @@ EndProject Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AspNetCoreSseServer", "samples\AspNetCoreSseServer\AspNetCoreSseServer.csproj", "{B6F42305-423F-56FF-090F-B7263547F924}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{A2F1F52A-9107-4BF8-8C3F-2F6670E7D0AD}" + ProjectSection(SolutionItems) = preProject + src\Directory.Build.props = src\Directory.Build.props + EndProjectSection EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B6FB2B28-D5DE-4654-BE9A-45E305DE4852}" ProjectSection(SolutionItems) = preProject + Directory.Build.props = Directory.Build.props global.json = global.json LICENSE = LICENSE + logo.png = logo.png README.MD = README.MD + version.json = version.json EndProjectSection EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".github", ".github", "{1288ADA5-1BF1-4A7F-A33E-9EA29097AA40}" diff --git a/logo.png b/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..89dafab9f19234f0f845444413fdc3133477b6c8 GIT binary patch literal 18307 zcma*Pd035W8#ex=lt@aXlu{v)CPXSLBr23NAPq`}&}3g3szDTk$4B_Sm@N2t}#z$iIAw{z=vNP@2AeJAIq`Ub@e2FBi(k z$4Bje+rcBwyFFag+`aZ)`J*?RqUKV@hHET+6WXi%cE!64(K<`&9tcl5IpzNCrjshS z4m6yUS-982dgtcNmtt>yQD1r`LF>!!;d^%zmZhjxeBHHk!3UO?*UPWFrk8&;T(fkd zkIQlcv6cNDQG&UPB0Qe9243s&%d_vNJ@Qq%f28(ERew*y5mghFiHeGf-3#qYCyI%S z#|(Q?bMe0hvQ$`Dn4Xvrg)gVQ;tL83E8_pZe^rf1VxGC|+o!Z-$ctzPFPK3JRjW-q|L!d-raav>lK3;>8Ar zh64Hd`STdd6xTIS28LT=;^Twuvb_~lRD_L)EP`_dKY%H(lSpef#ovSz3m7`_6gu=GDFmmnfZY zW$Wv^Qcy%H=mfuzQ)lhV+cxRf=*EWiD=D$9EUl$WGrXEiRChcS5Ed3*sHz&L_I9_u zy?x8)B%wdq9jirTv_&>w(T-OO-zb2SWt$iq3u_on_oo%vJLYwJSgL!zRh=sJd5Uh@SNo%()ATh%^CD*bui z?DOZ(Cl_l*URYx5RGMrorRgMaJRpEotl%|Slrog750wvmLF08zYpcq(Vb3Ty6BhO& zEj{;4T|sEik%>i}c<-fMCMJ{Zk9V!dNg1+dd};Z1PiF7?izixI_H!)4+TP%O$=%)E zo!!Oi4Oe}t*LZqn&~w4A;kQ+W!lWWJG!8XDvKA>|fAW>T}&*UzFprY%L_24a6 zS7~yW|7}gryJ?&0c2U>oK3&CdW<6e`VWN`L_w!&@!#UmPOP5saM6GUIzfMKz_es4u zD^u99V{UurbSmb=uH56&NgJZxhiJ!Cr_Uiczm#Y3wuVl zM~+a?#v^y`+-WIKmoKQ9hXn`QKR>p+@Z1~>4uvu%XT-(L=>1bAlgArMqpLI;Ub=KC ztNm$3=NB`YF>|e4B$EnTcC_V_!mBrL>f3%i!ebEv6DRI&|M>)Z5Q-;GKm-mfoIih} zrl#h~Bflc?k&}Xg!T?0>6U%fK$D*hJ8z~hjsOkBdW;2b(8&Gm%a~9z9Q{?la8|y;F zBqUB9Y5s`!xqVAEmN-=Lbn1u8%VX7o^#t4}%qum7d=2$?lyvr+r);^Je|^oVf%$72 zwIL15UN|!*1f3F^R$s#4Ej<$v!7^2t_JS{H<9E#ZDbw8{gvLjGySw95%C%!AY>{q? zoQIeX&+^iG_>0sjy(q#TS+w_n-Sr1p3T(?O0}BVxs)cC$7Pe zuq4>B+YWiFe}B6d0TcI+xr0?O3=CX7dGcgp6(b`>l36STSWBGdV#s_lLnQNAU5Lzs zgXL#z3D*z4rG2D??*xghdbNTY`?m~LzU{AC2t1xkF{4I{(OX5)o119&+^L~5o z-*m?Mj_T)iP4kC;-JGNA?fCNK!~tk6%=P@85sw6fgq&+~1NMKu8BAB%qln|Ld=Xh! zb8E9qq|6FYC8J0K2nDNHB?Xc`%InYT`l#FCi1|vJR^ByBT>bsQ?o$In>wmq(0la=M z$-BDhXuhfX^V8XX*u@&V4_4H!0It`RK6R^Gnv6lU=8@%fJYEhjda zW3kJvEY(VCxog~wYv~`a>N=O-w+neDbgK82&9oSaOLY+et9<@Mjtuwv8xHWlXwR%U zm&o8rLwQPBmK7zm(MbHei!GwH6574RDa3g+MrlKRN@8IC*%j3b?atT+hlVOCDDYua z&h9^+7xnxe-l6fu?26*2VkDB2ldm&Ic_C975wA}&9Rj7HRl#|Ad2}7cyVi@VeH*48 z|667g((*D~Lb>zv26chXB_4ZG(-`ZijIv{vNMUF zz1;P5P2lhcG5#r>P-V(cRAcBPZSGtOpDigEogFaT_j>4W>(;!$0FFf}{nvYGobU$h zV&OGP?8n;{-O=mU=fb#;u1Q=SkZk(-8yqgtdK@jsVo}-S1KVWvkIl%<&4qn=*$Mk9 zy7$N6Qf}HenD4u`nW8st+`#etZhRZNJ;yhLF1^P_RAK&>3fdf zQrs^9$wE7mV77PrnX9@!7@#+ommf?vRVgelpOs>ksNKkvjS<1t?Sx=#-W3;5iI7~fwjg9G%T%Qq$~f>l zEj_t-E~?LA*8TI*(R1x4NK@*3(S;2eG@V5-Q~Jkxqt%i&IXcb- zR;+DqR<@gbAX1rX{4B+56ahXf|J^%ZU42?braM#Z)H0}$o@Dx9>{9)a-Y=!|ce&t@ zO6N!aT1iE3sJ9t9|ETI{x!wMskMGc>U7jAUSYS8dz&U=(Pqw;q!+pmmJ2j6FcyP4d z!BNlAzOtDuQYr<95tV;6&%V2-C&Q=1ex9;&1FpO1?b|gQH%?l+Zrx|tEBc>GX}G9T z7i(KDFRh3oKN@;l4dxw)wke+*rdg@a!YOv@UzO)EP? z8{wGw)}9dR{IqV`fl;f>n3xzKwtV$GuA<%KAX=_W5I(o_gH2G~Q zTh{md`k?9hbs?~8?z>K*p!4Ua6JOU*7_|Z4bitM>EM8o^d1l4FmQOcI=f~-I)CSRo zlQl)DJ;zj3RHQTIm{o~O-O?r#@rpwEW zi?39=J!_IY9UN@T`d!Tlzdcuy;BM=8{h^2OKR!fNbhw) zWv=V<0!NaIDJuEat@=`yDO}4fT%StUcZcd^54-lX9bnGZ^}cIe;s-3VJ7YU}|24{-g%=<2XjXTB7pHP@)zQ=n`4vh^1x-vD zSH*er1U6q@7Nf>bd2}}#bEa?HCQB8~5S7yl`~H3VJ?|6CcZc*3n&BYkaZNwKc%?l! zSn>28U6=|YMrwR`r*E6OS^f9XolJFyH#vSih6l4O3=L0XkYj(dTJ#{G#JYxzJU!0U z(RgA@asDk@)Sf+iHZl#!E<;{BGyGPyans|@pFfFfH)Zls02R69Ep2Uw{&`C@dCTvR zyw)Gjj-=qL>mO41>^p`fi;i?vP;Wi5dYH{0`v=P{O-#;^2Wx8`$!U7J3v68v4;BLH z*Q+`=l76%)n@_o=8T`kM%|n`vumHvjhN~W)Se_w^aIe!KTM!+8U} z_1je3d%=>-$_WexgHw8YI+Ukfir0N>)1{MlwxyUbcW16SCAfRAyJ=@gF+nl5ZqL@U zMV1T<3|u#5s*1E7 z*~|7vLtM_&Wfm_#`rEQgj>A5A^5oZOg>_$ngi_&Hk`ot26-rQEGWI>p!mD|$N85kS z%=YQHptjDxy1JT#JAd*<11lM$Ba?)MW7OU@0PJQu4iq~NWLLZAjf5b4JJ2I(kkr}V zUx=VI9Pz9(5&(eTrSts+0;kV?CR_7cIjXKh4zO>}Km`fkOfRUu#1cNigKWB@z4?m! zwq;8p;HI9<>SQ2*z`dPM@`2csO*MnzRT_Y>Ue^E$o6w4bWas$|^Ie+bJ`h_d!>a@m z8jSMId!Kdu`0=lubp=+?<=$dvA$BFD z3W0j`w(*4q`qTtu`qt$s51Lw_8A+t?b4 zFKO&P={uUW$l>|1zZS}7*Wv;%?T1VHK|Fv6L+8p0cWdi3tDMkXR_Vw7{=W0%V7W=& zuE)r3xJHhT`0?XM>iP)Ddi}=K>W4e;{f1|;1V|WSCCw3~ES1LJlJVn^DQtx`cDDpe9@N0aNaWXHqP@&nE% z%h*Q`9&IcV=P+X>S5lvjjvci6L1392PKn`SJ-uD+6`5v3F7tt1tis2Zw}Up)8w(Ya z>`-DJvDv@>w#lYVae;o}@DlO$V=tF1sHt2$Z=T`d>YN=zE(=2NXxR9p6;BUugK4f0 zX!L5=DlmF!FH7B)4Iw9g_th)IkUXJ#@Ci=>hP^q=s}-Kq^)whjtX7k&f28crwhiq+ z9&H$EYPQBxBI!hKihn*mER#Oy-#K~OG#dboQuTG2uw*7Gf4E0qbTVIGrOl$sZmyql zw6ARkhnZvxT?)w)l;S;<;_b4z4_Qgg$`mWvmD|A!`X4`Ragdc%Kx1{@D`pl>BYPF#o`hYN_J!84EHBT@A9X-d4~am} zKb1PNv_M%ngpDR9`9MWoJtee;`qvR|JmX4|r^@zjUkfA4GWA>~O3D4IeR(SE?Ag~y zGbEd4m?FZ?{ZE{djjNcyV8KnFj_QSKY8TXAyFkl7rI^VhjdQ~$-M$6sQs+Ov1>s=u1_&q%8Pxz8m2m$i~v+a%<*w7OF{s+{X`X)u5XO|UKq zon}+aRJR!%9CYhAjEvh)MBlSlxFtZ?Z}`#@o?i>-+mYG-wQMEjJBd77r(S$_1@~{; zk8K|kX%0=lewk!uZ9)cfsIS7k%+9CE<#PJgzV2=dnH6qvZuhp~qA3xghdcI8VYs`y z{{;}fL!zzBK6c=6`-;E)d82j{1qILafB0OM<98(f>eVGx7AbX51dZ2^{ZLRj`egh{azI zA1rYNvRkxpVYJ(gf|b-ov5qm3b-9o|vf=D(m(+tF%NH$LWC6gwyzzS9P;0trX31_$ z8#1nadsp_QBTqc^>xz4_Ek_$(#~P?XqQif)wYhops(_)#^j6t?z88jYkI<3#9&I&9 z?i_9VuF0`x+XV*Z9)rz&J?s$c(knAThq@>bHA1xWQr-7a-f)LaaBy(xy&21o{MuA- z+#BfHYPi3H>2|3K3#EYF#%H9tRj%Y{yEY&Q(0t!4Scx+)ZGR{uM4f_U;~%Yc17_Fs zcCgR>G~Tqy647&g$>yWhPEI%J*=<8+|_*lq05tVLi|+x_T=<)K4&2aW`^yOyQK(+{Qw^9Su6Uz!xpQUa#+T}g=~3>r?jE>#sagUo!lp6%~;SZpBAEsZamxydbd+Ds&I^3uPYH;n~fbH8q$uKXI@eQC4z=#e7jJfBen99}*Ml5SOKTHoU1%4_;gj2(_r{ z!Xi&f4B(qQeU+y3#n%1#eBQAvuaPEoMvR+r{7PyPE*+xeG!Xj;HK2ok>kOvOUS>|h z>?QH_)ZCzduHNi^cVn#CnLO?LyNK&patD@v#kdsKFK2kM90CW|bN_laU8XT|>86Wb z^SwBWbzNid{JK`JdRX7kV6|q=3A#-Co6hnLTeh4Vg1(g@!+&F_my?8S_RW*0PFXoR zUMH?8v-()tP^-geDpWmXOXBJ!c5Y`|de^TR?HC=Qal9?h@CRKPcXfz8r$KLQqV&4M zU{P-Ol^ll5!6=sj&ajHpFL1u3MC4hU*gzOq6tkcd+Lp-(TzWuY?ubW_#aDMMU>ysIIv= zW$%Z}^GBSm0FbxTr(Y?JkBggEb#AgJ<)JWc(|{rZI$sLCbA7^2UV*w%7IBt5@x{qs z`uS0x+0LFrW>@^r>{oP-+$xUB-+;{Mh_m%V1%)--zuVaK5vRGLlp5JU=FnS!hiket z8OG1Y2TEyfI@rX!iV9oqQ2_&eZf8Mh`)!l~m2p2nIFbbp)sfOmD}SoP7C&{bQ5$h) zCKXrk4fk@Cs?LygDvqyHZn*e}&j9oO?b{2jcI{FfX>f3Pe^IkOU71St>-klBZ){G8 z3u0eYJi$qSWtZh~gFfYcH*&yXdAF#A@DWy)me{@5N@^t^)Y*rihwfx=p3QyHIjc5i z)-8ggljtz!tn%->OV@o@N7Vvk0Me)e;is&_%aM`Zn3?n*xv%oIhb!MyS-+t!!JsO+KQ5kdn;krOBu5HmBEiHSr&y4eQ*L)ze z9A)b3ikjotFqZcH1f*J*u>;`n%i(4RHiR$!!`@govr7O7#$;%7B13I#=vT4vU69DR z;p6DLv2a^5KK$G{$qpgvFDE6@B=e@MD7Bp2%hfzp+%<>Yljk)@|Cl9vvkR(@bE~IO zzmuX?pLbiYV}IQhrO-8-Hi>*p&;jhRo50Ucs*k;`Qz$ zaFJ!2Q4F*D8Hqg9g^Za_nIwVox7>k=VF+@xulfCwMwTuO_?~@QYdjA?O`d{U)51`G zgXK^aGOv5?;4QkecSKZFA*=+%RvE9KE+H{ho(C_heSE;|qQ)9_r0X5K?5A{LmzJP(pi4I5qW<=NF*D6*(v(uYcxT zSaJC0xG3%-_g$wRQKw#VyKb5R(oS~l02^ad(=kaT={F*Yoet1I;98QsG1Bi7x=!p8 zDeu_&#-jop-p`_=nqk78)8s*!i!kOOOd>ND=`twSAO8Exg8txP8>Qmwz<4tHPDQsUG?iZ+Sabn$a?)nc5Km9xfRs7VI2=4kBtuJjV`WE zDgFCnU!rkl(ptIY|MR^ZVz%iWR-B>1=0xmIAxio`4jK-}Ckin&u?Ss(eCCMZnwpzU zGn3cKY5va~t5E~W@Xa%^K@3UPUF0&v_pisnjdj>(WMtIqFSbM3DcWrVYm@#z&qBfF z3TmF8lc(L!$;o*&Y|UQH?OeyXVEOLxzlSmgqW<)knyQEQx4&bxP7N}-M5o4b1LXV> zMmxYG!Qag4u;WY?6}4W!etqfTJ8>LAa#AozWB-kW;S2Bo^KSW`A~8(=*7D!!$0I5r zd+Wm$PiJ=2#J2(t#k!fsZ(91_`%~Zd`R4lik!o*c|SEnIr|ncBKB83H074{TSV6q~v&<(#j4 zx*cNW3vM5dN_+pa%klWKI&qY{uWPk^_H6A#w@pk;l5LOJg~i#`~vGBL)DiTG@4}CY!Va~hz|JI%1LIDf%?aIqcoDd*j`p53ocAt7&` z=I))!!6Oz|v=5(mOIjDn3oQ}RC2&>ey%o`faY&ov zU3Sr%|Ha9PQ(h%*@@Gotj{*QKTDHtGhuNnVlE;OxX9AH9FjqpqT|)zj0H>q~KBHF;RpE-MWW=D#Caf>bk+XXhiAZ$4E<+j7T_ z9i{h2lB#Uj^SQX97eu_}5@+N-Tq|0E% z4b`5S_R4=Jj+KaGO-mt9grP6B94jhWJ-mq>u!Z%3(%AoLZkKZAO_y8b=&$PgfAf(4 zTinTnm;2#zp>xIW3>pQs*5LH%T-D}(0Vc>2o`6F(YW5~7%TaLa%Kf%SdgL->p{eU~ zo?K*3PgGc#Ifx^rOX#Z(3kId<4w-O`bGYD8+x&~iQf4`d#)U9c7OCkq)TTC zV(3+>5HlYP9r~Deu>AhGZ&YKIQP<-vP@tUU_wd7PGPiG+Q~=psES+~@`=9* z3+6Cgr(G}zh5H}v48sq{+S0$uXET&!UrJ-y1&MGHauE8LFJHQj@E=W{;Jd7 z(<*;M!!5(1STp5YwEX8`4X zwU;~4<;@5UNVk7Jmiq>W<`Uu_JneFj#~mzf&yX2|fX5sMWD<7^23f$a{suqJ3LJ{^ zs=B8Kz8IaAr`fkxKeuHc%KY+oy-F3?IE|mwnB* zUYLvkbS>xpebKo>UX)r8d-38zUW9kM>(|>c?>>IK;I{cJ5)PmlE1sPiIxnsz?k zA44}yJxf40Sy*!|^g!q6PMP)y?KzFQkPske!?bZe(wmt^{k#zeuh=^ms zTzVc4g>7#H^b5wLw6<>m-goVv&qn$dIbj7joUn+9fjLmlgd<{1xHaU4-Q)}zu>RB5u zd@e}z8OF7m&8(YGNo?G_IUY4+!d*k98`QVDZ?^8Qn~IrOas@*1&YuU2}Bb+j7A#M8xvctgQXp}+{ z9l(gAMN!~rl+HI$2^Ny`rS^SH0L#n`xla&CWc-@t=gj$VHBT_B$A_PDP^|GH>_J!S z5!S)}KUJme=0|?L7w)SmR^oI~#xO8qr2<&4R789n^ zEV<$AS?&{-Wt}`ZfovQJ&d%=h{yIQ%$GKgFPEj3Uu)or)xPF;=awhHrOI^vU`Wu9? zlx~i9DMJroZSsc-g@Y%@G8nBVbQ#imd>UE#`D_2-0o;tr+xubm=fcd;&o#e^{g>kH zQ5U5IZIIMKY5qlpZJ)*gRF`f>Icy`be{U$aGk|xj7Sx`TOiJXV>k|_uMWJ*n9&r3> zt{CT7WMEqfrpfA2-q0oRqBc3I+SIr@!tv1$50DQs3e$y`R(9@dyqb3@x0I>N@S0&p ziELr=fj4f`mH~pIz?BaR`Uc9zalsdUA6}y>7QB*1qmcyzQJ9;A>pfM|zkLS24nPKs zr;o4rUetmqjZ^I`oF5c1OZ|-AQ7yKVnD<>~B!nghg~Hh^CqqywAw!V5oaNv4;)Q`8SPxE74(~)( za7pBiVN*CAN(&0lN-s6y>gMn*#8Fw9o6r3g>RfnE1ts5%M55nLwCtrhWBFi(4c72O zWsp$RMjk+}Q2 z6ek)4&agat*&Uxhf8Lq%O%|zc6&R?S*l#^!l1VvOjw)56tT+oWq|Jeyj}Dd05)-@r z?Y`aOkp`X9#Ldu*>-Ayj2^o3%J5@WjC5Rse;4D1=x3;(CbHRbpUx=m8!0#)lseL>! zdMmr@5!M*hKi{)dVvs857n#H!45=AV|n~PMJn?2mrr56=o0woV1;cMz&AK{nbM)O7Tpl zvR!Tg@csXZREtjEnA(_WyrOr!Py$G$PxZzIOfvwtw4ZLvpZSXpv>jK z9jt;fDYDz2mV;}3&oNW4?V zc8|h2J{y^y@pz{r3TdS-zBB$1SfgA;U<-)cCQS2>k4jcYfPBW$(whL}j(NpV8N3AY zjS}Knc4S&xO`bf;_xI`2xBjtfq!9R~uuzDUv|QqPz++YdUxF?21=$aHZ>{NgdoRkC z#!T}q;Q572lRt-e3tb1HKwTQ#xBIbhb95Jsk$;Q`-{6gIM~;$R$Q@(`AXL)gKnUO! zNUc7eMVFp=j5pXk_=DO4_LUr=6r;ZYV?=3_zb6B{oCF7GZDC3#%>VaC`=*gPj@_Bv zM9j=*^H4fIk9szs&Kn6T*0qZL#9MyqE&{Z(0NTdrtY;L);1*4K4qhrl3(TPl$Nzlj zGR5fZY*v$S@W*keq{VMPK|_-@gYfG?d^BZR+(FH!Yw3j4@S5K#So5WcX4IzlP8p7s zS)QdXmIok}z64Pfe?mT=A{mgWa(mC?$x_|$lQdZV005?MQ9EUd~nM6)t zmKmk@9`V`~q?$NduJh0U1+zv@jNpV~&&vQgdLY7*7McPF2@yv3!ZUgwN&C&j7tv{M zRqWpmqeIL^Xhm{Ms#0^vy^B($zE!%teplcs=k*&lq~R=0GRtmO#%cj(2 z{EIN;4xwH|zD+LnID?Lgx@-P_UScmcXe-HgeRAfT^P?XRJR6MOC(`5*Vl1!Hm6jS4 zNF@*y9#mHDB9z_n7L_eC<>b!c3}rxLT0w#^bYo=d{Xx|Fz^`ZT-R&6@(0ug*kh8Ko z>ko>G5Di%r9Se|+ofeboZ9YpQl370dR2q7Wi)K#rC;?`3Y4QaFzF z9v&LND78(086D?7ynC0AZh~{bp-`#Gq>(O=yAo|z9-z~_Ow1n{-{~W;Y8J9Ikatma z$lb-BQ97fek1ReRoS)*O9zJ^X`N=^WFttI>M>7pEVP4wcsqsH1iK=cMVKLMmWo}s(P2+2H5^ap)5ixBOdBpL;3T#Q<9Wzd+r zeTI5@s>SZz3V+zGYIk=$GGfp0QXnV?552lV-7x`iWdQ664{(u9nQPTbNuv(o6E(WY zQY~yQm-_&zmrC3(_7gi*PVZt}Iv>0^D6D0WzEdD0PbYbQwcvzC()VM1cl!y*lrghj zEQA&lu#z%=vg4lh@gYu%?_d*R5d|TAFyRKcJtcJw4XCZHlj0fnHEa&r!vxp9!JRQI z165MBn_LFA#p^uYUv<5~##k_GBJ0c=rNF(;L>Y?@R3>#?0)V6IZM$r3-be?75C;Dl zhGvb%XyC(2|BmP1L3pF9SOymrZ9I;q5P06_bQMwO0SO(U4!*gehK7cYU^`0bAA5{Z z;pFt-0GtL62EmPjbtT#ZN@AfrBNE1BE~p4>*`ajoZa0z<1N9N=o4S^lh%gkJ>*rHm zsnFuxAOfQC;SpU$ZporWlM@5_q*10uqsTT5Zg@fzi1(I|<5w`6T_9ph@s{j0YHV*m zJImge56qRl0|!smnX&7Isb}wTtS9kaSwc+1Y&Xz5GSHF~<$*$j3A26~URqv86ZtLvs z&PVa{hHyAJ%9a;-Yyd1d~1r*;VvOdED+P zgxp0Elf9nztQUjC84gMSnhix!L0<|edkzkTx%&QR$X+k{P&TE*se@s+&ee5MX=$lP z{VU-FeSb+L?26vMH{82-f!C2Ed|YvJo5@qBP9#uOK~?qcA!LEXaHQ+d69M+}2^>s5 zvZC#@D=}nR*sri%=jzOor$j|6upSt@X#X{ zvrUs59(jVF64#kpkXW>G>?6z-8B9Kcn(xsgGbmu+&SVB}D62HmVu}x^VEA_o--={f zcqDqP#LFh(BU$p%6MXdk6h5*dqjuq=&qv8eU~Y?Bg=5k!nDn*Ba{#lqRZ|1tEDzFM+jR0>vObr3-8RnvH>qxaV1SSt+t^inGtQ!Py;w|7d*w3;WJU7F@wJ^_BPq{wq#(Me9UUJ zeihY1wZRY_OHEm%zH(+LJ}0xjJdBFmaA$J{Ehcbm7>PdZ*2ZHs$;vn)!TyFQ8lo5# zu9{>oMF|d&-vy8xmf%G6Q)1HF0m;yq^o08k?W!@=WF;rszh|r~?rdJpP#hs!Ji$s% z-pDi;O&^qy=7*T@e`!x*__dksk;V0kw1Gg5EXHmKEj+IxzbQ$}-FOc>g`JT`vZ5D( zqa&o{h9YQ_L=V!2mi**VRdsbUM8hwfqx8{QC0<5;B7pyk%UE@eE^KJIjtqLg_mMHu zK4aW?v8_|dB|bnqADItLm*>?^gt>-6E>D2(Nzy|D;O!-w&b>JsQoF~Ioj@HQZqFP5 z1ZNfFLpbq0j$@5DH{Lt&x@R52(XmAoQ<14P6#NDrHDdHe^hm5;E!SF}&QuEyONHXb zoZu{@D8_O9E))gdDg+f#&<*MBNL7K$f~Z=4U5H3s6Q%fJN1TNTdy?Wqvn^Xh3Hl!k z>E01WG2lcfazSXUzC8g=AzBa6Wo@{Ay)kpEg1zY6F@tfc^-D?=BCC2agJgIJL&20` zaorB#xup_t+*%}$whX2TymIs+hW87Iae^VIg3W-EV^ON7U5>0l@+_hgoe0`-;Y(yE zg!R5O#Rq8IKZ)8w9rBxa*c2Yq`u?u)z>y&|JvU}R9rsKCZ&_l&CiKqz9LRVHiNt5q z;SBbpHD-(xWb&lzje(*LS-UXOJ|s>kb@@7}Msef3F@3SX4>7Viq8IJV&+L@f~T5{6x z&)CAh0@bSS$`T_#r4To}!B!x=5;iZ!xXQC|j&FUqGAbQYa714E_7mo6WgvA47V~Zp zp^>BwX7Y#af;EhJ+tk>29sc@zrh6h?#k=n83B&uO4VXV+b--+hB=9gQA>MUj293wj zp%Bi9!dy+?tBtUU2-b z5Y!<$*Gmp}AQ!TZ66Yi4ae64FNG#}$l>%bphBI;<71K;Usv{o}(R&4%8v98M3Rk8# z6(_Q&03RLc%!Un5!0%0v{&(W}S>NYtXo%q#0oD@!sHsA!B*vyje+~@-vye3AqE7~$ z>l;n+=GzuX2^xXZH5TojvCA(g$UrCfGEkAwz2Dv`hbQAccL=Za`6Dam*C_6hxXx0J zOhqqa4{I92dD@w`ABFQ{H>z9^5o$G`;`0wNKADR4! zpw-EMfi(t(jnmly+oOTU0nx=JB^TIDj**1y8mir>Fg8F&6PC>ero>P!>5D#J)as$z zuvR-!lTh^1;S}=$T;>D9ZB4UY5>u#LDsF}aH6^PH<-nqgFm4`1hjCb?QT@E@s6T&a zA60NPn%ZN|-do*~6haUi}B;YZ#CQt@_QKBQZFbm}OF8VrZqELa-xw95T?Ub}gHXvhYhl1r1;Uv>t4D;53eceincDK#DoLpX?N$K3&mHG)9HoJbq3l qM>zWb?H6Pq2><7IXL?8Zig&G1buBuu7(bvx8L!`Bcz>qY2Azf literal 0 HcmV?d00001 diff --git a/samples/AspNetCoreSseServer/AspNetCoreSseServer.csproj b/samples/AspNetCoreSseServer/AspNetCoreSseServer.csproj index 601af56e..cd534dfe 100644 --- a/samples/AspNetCoreSseServer/AspNetCoreSseServer.csproj +++ b/samples/AspNetCoreSseServer/AspNetCoreSseServer.csproj @@ -11,7 +11,7 @@ - + diff --git a/samples/TestServerWithHosting/TestServerWithHosting.csproj b/samples/TestServerWithHosting/TestServerWithHosting.csproj index 3cd5eda7..137d753b 100644 --- a/samples/TestServerWithHosting/TestServerWithHosting.csproj +++ b/samples/TestServerWithHosting/TestServerWithHosting.csproj @@ -8,11 +8,11 @@ - - - - - + + + + + diff --git a/samples/anthropic/tools/ToolsConsole/AnthropicToolsConsole.csproj b/samples/anthropic/tools/ToolsConsole/AnthropicToolsConsole.csproj index e0924d4a..cd611955 100644 --- a/samples/anthropic/tools/ToolsConsole/AnthropicToolsConsole.csproj +++ b/samples/anthropic/tools/ToolsConsole/AnthropicToolsConsole.csproj @@ -8,8 +8,8 @@ - - + + diff --git a/samples/microsoft.extensions.ai/tools/ToolsConsole/MEAIToolsConsole.csproj b/samples/microsoft.extensions.ai/tools/ToolsConsole/MEAIToolsConsole.csproj index 6aeea658..d04a44ed 100644 --- a/samples/microsoft.extensions.ai/tools/ToolsConsole/MEAIToolsConsole.csproj +++ b/samples/microsoft.extensions.ai/tools/ToolsConsole/MEAIToolsConsole.csproj @@ -8,9 +8,9 @@ - - - + + + diff --git a/src/Directory.Build.props b/src/Directory.Build.props new file mode 100644 index 00000000..1a1064e1 --- /dev/null +++ b/src/Directory.Build.props @@ -0,0 +1,25 @@ + + + + + https://github.com/modelcontextprotocol/csharp-sdk + https://github.com/modelcontextprotocol/csharp-sdk + git + ModelContextProtocol;mcp;ai;llm + MIT + logo.png + true + snupkg + $(RepoRoot)artifacts/ + true + + + + + + + + + + + \ No newline at end of file diff --git a/src/ModelContextProtocol/ModelContextProtocol.csproj b/src/ModelContextProtocol/ModelContextProtocol.csproj index 4e5b890e..f1b5f6c5 100644 --- a/src/ModelContextProtocol/ModelContextProtocol.csproj +++ b/src/ModelContextProtocol/ModelContextProtocol.csproj @@ -2,52 +2,39 @@ net8.0;netstandard2.0 - enable - enable - Latest - true - All + true + true + ModelContextProtocol + .NET SDK for the Model Context Protocol (MCP) + README.md true - - - ModelContextProtocol - .NET SDK for the Model Context Protocol (MCP) - https://github.com/modelcontextprotocol/csharp-sdk - https://github.com/modelcontextprotocol/csharp-sdk - git - ModelContextProtocol;mcp;ai;llm - README.md - MIT - - ModelContextProtocol - true - true - snupkg - - - - - - - + + + + + - - - + + + + + + + diff --git a/src/ModelContextProtocol/README.md b/src/ModelContextProtocol/README.md new file mode 100644 index 00000000..b2205768 --- /dev/null +++ b/src/ModelContextProtocol/README.md @@ -0,0 +1,177 @@ +# MCP C# SDK + +The official C# SDK for the [Model Context Protocol](https://modelcontextprotocol.io/), enabling .NET applications to connect to and interact with MCP clients and servers. + +> [!NOTE] +> This repo is still in preview, breaking changes can be introduced without prior notice. + +## About MCP + +The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables secure integration between LLMs and various data sources and tools. + +For more information about MCP: +- [Official Documentation](https://modelcontextprotocol.io/) +- [Protocol Specification](https://spec.modelcontextprotocol.io/) +- [GitHub Organization](https://github.com/modelcontextprotocol) + +## Getting Started (Client) + +Then create a client and start using tools, or other capabilities, from the servers you configure: +```csharp +McpClientOptions options = new() +{ + ClientInfo = new() { Name = "TestClient", Version = "1.0.0" } +}; + +McpServerConfig config = new() +{ + Id = "everything", + Name = "Everything", + TransportType = TransportTypes.StdIo, + TransportOptions = new() + { + ["command"] = "npx", + ["arguments"] = "-y @modelcontextprotocol/server-everything", + } +}; + +var client = await McpClientFactory.CreateAsync(config, options); + +// Print the list of tools available from the server. +await foreach (var tool in client.ListToolsAsync()) +{ + Console.WriteLine($"{tool.Name} ({tool.Description})"); +} + +// Execute a tool (this would normally be driven by LLM tool invocations). +var result = await client.CallToolAsync( + "echo", + new() { ["message"] = "Hello MCP!" }, + CancellationToken.None); + +// echo always returns one and only one text content object +Console.WriteLine(result.Content.First(c => c.Type == "text").Text); +``` + +Note that you should pass CancellationToken objects suitable for your use case, to enable proper error handling, timeouts, etc. This example also does not paginate the tools list, which may be necessary for large tool sets. See the IntegrationTests project for an example of pagination, as well as examples of how to handle Prompts and Resources. + +It is also highly recommended that you pass a proper LoggerFactory instance to the factory constructor, to enable logging of MCP client operations. + +You can find samples demonstrating how to use ModelContextProtocol with an LLM SDK in the [samples](samples) directory, and also refer to the [IntegrationTests](test/ModelContextProtocol.IntegrationTests) project for more examples. + +Additional examples and documentation will be added as in the near future. + +Remember you can connect to any MCP server, not just ones created using ModelContextProtocol. The protocol is designed to be server-agnostic, so you can use this library to connect to any compliant server. + +Tools can be exposed easily as `AIFunction` instances so that they are immediately usable with `IChatClient`s. +```csharp +// Get available functions. +IList tools = await client.GetAIFunctionsAsync(); + +// Call the chat client using the tools. +IChatClient chatClient = ...; +var response = await chatClient.GetResponseAsync( + "your prompt here", + new() + { + Tools = [.. tools], + }); +``` + +## Getting Started (Server) + +Here is an example of how to create an MCP server and register all tools from the current application. +It includes a simple echo tool as an example (this is included in the same file here for easy of copy and paste, but it needn't be in the same file... +the employed overload of `WithTools` examines the current assembly for classes with the `McpToolType` attribute, and registers all methods with the +`McpTool` attribute as tools.) + +```csharp +using ModelContextProtocol; +using ModelContextProtocol.Server; +using Microsoft.Extensions.Hosting; +using System.ComponentModel; + +var builder = Host.CreateEmptyApplicationBuilder(settings: null); +builder.Services + .AddMcpServer() + .WithStdioServerTransport() + .WithTools(); +await builder.Build().RunAsync(); + +[McpToolType] +public static class EchoTool +{ + [McpTool, Description("Echoes the message back to the client.")] + public static string Echo(string message) => $"hello {message}"; +} +``` + +More control is also available, with fine-grained control over configuring the server and how it should handle client requests. For example: +```csharp +using ModelContextProtocol.Protocol.Transport; +using ModelContextProtocol.Protocol.Types; +using ModelContextProtocol.Server; +using Microsoft.Extensions.Logging.Abstractions; + +McpServerOptions options = new() +{ + ServerInfo = new() { Name = "MyServer", Version = "1.0.0" }, + Capabilities = new() + { + Tools = new() + { + ListToolsHandler = async (request, cancellationToken) => + { + return new ListToolsResult() + { + Tools = + [ + new Tool() + { + Name = "echo", + Description = "Echoes the input back to the client.", + InputSchema = new JsonSchema() + { + Type = "object", + Properties = new Dictionary() + { + ["message"] = new JsonSchemaProperty() { Type = "string", Description = "The input to echo back." } + } + }, + } + ] + }; + }, + + CallToolHandler = async (request, cancellationToken) => + { + if (request.Params?.Name == "echo") + { + if (request.Params.Arguments?.TryGetValue("message", out var message) is not true) + { + throw new McpServerException("Missing required argument 'message'"); + } + + return new CallToolResponse() + { + Content = [new Content() { Text = $"Echo: {message}", Type = "text" }] + }; + } + + throw new McpServerException($"Unknown tool: '{request.Params?.Name}'"); + }, + } + }, +}; + +await using IMcpServer server = McpServerFactory.Create(new StdioServerTransport("MyServer"), options); + +await server.StartAsync(); + +// Run until process is stopped by the client (parent process) +await Task.Delay(Timeout.Infinite); +``` + +## License + +This project is licensed under the [MIT License](LICENSE). diff --git a/tests/ModelContextProtocol.TestServer/ModelContextProtocol.TestServer.csproj b/tests/ModelContextProtocol.TestServer/ModelContextProtocol.TestServer.csproj index d8826c64..67dc6a19 100644 --- a/tests/ModelContextProtocol.TestServer/ModelContextProtocol.TestServer.csproj +++ b/tests/ModelContextProtocol.TestServer/ModelContextProtocol.TestServer.csproj @@ -10,10 +10,10 @@ - - - - + + + + diff --git a/tests/ModelContextProtocol.TestSseServer/ModelContextProtocol.TestSseServer.csproj b/tests/ModelContextProtocol.TestSseServer/ModelContextProtocol.TestSseServer.csproj index 77b3ccda..544be2e0 100644 --- a/tests/ModelContextProtocol.TestSseServer/ModelContextProtocol.TestSseServer.csproj +++ b/tests/ModelContextProtocol.TestSseServer/ModelContextProtocol.TestSseServer.csproj @@ -9,9 +9,9 @@ - - - + + + diff --git a/tests/ModelContextProtocol.Tests/ModelContextProtocol.Tests.csproj b/tests/ModelContextProtocol.Tests/ModelContextProtocol.Tests.csproj index bd65b031..6d31fac7 100644 --- a/tests/ModelContextProtocol.Tests/ModelContextProtocol.Tests.csproj +++ b/tests/ModelContextProtocol.Tests/ModelContextProtocol.Tests.csproj @@ -12,18 +12,14 @@ - - - - - - - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - + + + + + + + + runtime; build; native; contentfiles; analyzers; buildtransitive all diff --git a/version.json b/version.json new file mode 100644 index 00000000..15f55420 --- /dev/null +++ b/version.json @@ -0,0 +1,9 @@ +{ + "$schema": "https://raw.githubusercontent.com/dotnet/Nerdbank.GitVersioning/main/src/NerdBank.GitVersioning/version.schema.json", + "version": "0.1.0-preview", + "publicReleaseRefSpec": [ + "^refs/heads/main$", + "^refs/heads/v\\d+(?:\\.\\d+)?$", + "^refs/tags/v\\d+(?:\\.\\d+)?" + ] +} \ No newline at end of file