{"_id":"@zihin/mcp-server","_rev":"13-03071a342564fb2805551e1b259a7390","name":"@zihin/mcp-server","dist-tags":{"next":"2.2.0","latest":"2.2.1"},"versions":{"1.0.0":{"name":"@zihin/mcp-server","version":"1.0.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@1.0.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"c9d56daf17450bfd3c0dcef4b6afd4cd9f9529ea","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":5,"integrity":"sha512-7cOZynvSxNKImGDqeYVwTJn3+jmbvA5JIlMxCZiqf1y6lfza6SCPZs2cbFLxRblI8MzG0WK+WObRsQEaJKwdcQ==","signatures":[{"sig":"MEUCICD/AsK1mwP1PVPkKVAIg4k951eXVrgDjtzCFuyobNoXAiEA3Irtxy06oSTDoYFpCeKUeEVcEWJYUZYG940M+2Ls8vc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14433},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"1ed01ec9ad59258e1d9ba7b5d058ef668e759faf","scripts":{"test":"node --test test/proxy.test.js"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1773110669801_0.7178353771962702","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@zihin/mcp-server","version":"1.1.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@1.1.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"c3fb21ffb4ffbf203faf9db47be3a981ba838c74","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-1.1.0.tgz","fileCount":5,"integrity":"sha512-TSsSPUt24GDm/vFSRaAk3Vo7N+EX1ADlArLcZXkkse70DbszCDJbjx7I6mVEK4ksh0spyNbe3SMwUkPHKBTuIw==","signatures":[{"sig":"MEYCIQCIVt7P5xZ9tYzlIjviB1aFmiV8QoT73c7AgqJzuQ1TKAIhAK6rm15YIj2T2E0UJEclb5JZktWCD3GWJdIYYkAJ8iW+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16390},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"1093642f2d95a7fd99656b63091491859f729209","scripts":{"test":"node --test test/proxy.test.js"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.1.0_1773420065508_0.2406012110667155","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@zihin/mcp-server","version":"1.2.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@1.2.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"e93eb408e3f24c719bb8518feee17c07278c7ad0","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-1.2.0.tgz","fileCount":5,"integrity":"sha512-OQh2sehIa3FLpIQTqOAcTXNYbe+qubPIxzrx4w+SXLt2MWiBB8y8icsL4zD2EmS/aF5q2RWfXFwo9HfmJdaMuw==","signatures":[{"sig":"MEUCIAvyXRtIHaebdpBijyNw9M+FimAJE72SKykLbWkhKpiPAiEAwwgoJhvBxqOcR+dLEHdNlY0FzYGo02KJtCFjbZlRsvE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19004},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"3b6cc9153afa9531df3477c28155af1c5fb5c7ee","scripts":{"test":"node --test test/proxy.test.js"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.2.0_1774110815760_0.1176921962951285","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@zihin/mcp-server","version":"1.3.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@1.3.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"d6137d3b7c5a6445207975d4db8cd202d19c2c87","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-1.3.0.tgz","fileCount":5,"integrity":"sha512-7xRSNz/zUay/tWC/3gWyHIOF4kUi+i1URNbnOZC+IwIJl8bqBGaY2rfCDTJZ+//mVkpWS0MqY4Mxt+UA/DOE+w==","signatures":[{"sig":"MEYCIQDJOwTrEKB1vcZkvPAfcZskWZ3JV1v+19fPOusm1oyIrgIhAKWGOXZ/IyLEWe9vR1NuUQhVeXT8hfBh0cyMocvscUvZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21622},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"d2da80e987324f9416e403a9aee7bb024da684f8","scripts":{"test":"node --test test/proxy.test.js"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.20.1","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.3.0_1774733996321_0.9312496363725125","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@zihin/mcp-server","version":"1.4.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@1.4.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"48293bbaf84c6951bf2813c8b0ed97e291a8906c","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-1.4.0.tgz","fileCount":14,"integrity":"sha512-1T/aXvzKIXMsRqpZQl8l7jfSFJAyD2LibMwkmfw/Noy/L3guj+gQOTJnJ+PsJpSaFzozqg7lfOgSKlPT6vpMgw==","signatures":[{"sig":"MEUCIQC9Ueu1ZjrHus56Yat6ZK2c3jNh5uFJOJFYzK6QJiCZugIgcBTGPFlWe1CULIXmn8byPHz7cZES4cjW6I4vrXZ7MoI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56723},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"c888392285a096751660edfe7db39ad40d4e9024","scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.20.2","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.4.0_1782951345995_0.533008694792358","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@zihin/mcp-server","version":"2.0.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@2.0.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"f0a0438de6260f9b12778e412745d9fc11885fa6","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-2.0.0.tgz","fileCount":14,"integrity":"sha512-KgE2WfZ0kSpVcNw/dCzfWS1kee1gDpzw2FQZWCMmGHKS2kYjD6toPZHN04YMYsBkA2qbStYvep/2dTa9dwuxIA==","signatures":[{"sig":"MEQCID8taslr0iQGiaXi7wVuUuL6iwm1pYEwfm/X8+X2DP1rAiB+m3W0HX5wMMGDBGn4AtaI7+nyg5l6myJLP/vQwQDp0A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62860},"main":"src/index.js","type":"module","engines":{"node":">=20"},"gitHead":"e590c1c801485d8b065cac0745cd292f481abc66","scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.0.0_1785677198974_0.09769997263377483","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@zihin/mcp-server","version":"2.0.1","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@2.0.1","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"6e1c40cb062f25e80a44a7a7cfd3792acaef06cb","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-2.0.1.tgz","fileCount":14,"integrity":"sha512-FZovhDSa8IshFcLzVjGdh0AP4Ew9nnsMiU0R/OCFoTYxIuthukrKAO0zpQ2CUYuuwOSRTwT4PTCufy/4uGQwtg==","signatures":[{"sig":"MEYCIQCVj3nxWe71t8LAd3EVn9s3Sm06XfFUISRHRNP+trXnKQIhANjALcCogYd7v+2p6t4AgLvjNTgCHnr0F3wUhLAx5/+W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63620},"main":"src/index.js","type":"module","engines":{"node":">=20"},"gitHead":"d575e83a789b8cb954f09620853ad713e07fa500","scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.0.1_1785678370200_0.033108376800701","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@zihin/mcp-server","version":"2.1.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@2.1.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"6935e1c7323d6c2ba3a6e39d9fdc4066aa499cb8","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-2.1.0.tgz","fileCount":14,"integrity":"sha512-0pSV3TjY5VVM/sd+chwnUEKwfZ2r+dH3tQM/hr5Zi/UpUIxqPE9YjsXnoQFFE2wn3LZn1QZjm6WQ4xoYG5cZBA==","signatures":[{"sig":"MEUCIFOlCGQMXCMQHMRl4j2dG/GnlzfB3ssLRSI5Qa1PWh37AiEAoPxqi8ue8zHRNVX6yeCTeGanbcu8C0AMCi7AGOJfDMg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65536},"main":"src/index.js","type":"module","engines":{"node":">=20"},"gitHead":"37370aa6c8e483a979fe79ba34d6348f588af2f3","scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.1.0_1785680788651_0.22441274788799714","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@zihin/mcp-server","version":"2.2.0","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","_id":"@zihin/mcp-server@2.2.0","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"bin":{"zihin-mcp":"bin/zihin-mcp.js"},"dist":{"shasum":"552786ad936a0bff0a45c8a1103a0aa187bcf3d9","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-2.2.0.tgz","fileCount":14,"integrity":"sha512-hS18MtXdRmbta/Pq6Y5laYLtY+zFNM6ZjrifB+kAjX2six8KXcVwdGQ6jOSgN+gbUjH+SfelUqu6qi6jxG/4Ow==","signatures":[{"sig":"MEUCICE3Ug3gx3m6jnvHWB+r75rF5zx+9BjxcJzN8LngEkl4AiEAoBF5ceOu6GNJ8CAjkEdb1K9QoTTrSg3i2C+cSg0obAs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":79814},"main":"src/index.js","type":"module","engines":{"node":">=20"},"gitHead":"d4226a92b4347edf8b9c32144cc8553949eac514","scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"repository":{"url":"git+https://github.com/zihin-ai/zihin-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","directories":{},"_nodeVersion":"20.19.4","dependencies":{"@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/mcp-server_2.2.0_1788221301099_0.17340397630640658","host":"s3://npm-registry-packages-npm-production"}},"2.2.1":{"name":"@zihin/mcp-server","version":"2.2.1","mcpName":"ai.zihin/mcp-server","description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","type":"module","bin":{"zihin-mcp":"bin/zihin-mcp.js"},"scripts":{"test":"node --test test/","sync-skills":"node scripts/sync-skills.mjs"},"main":"src/index.js","engines":{"node":">=20"},"keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"author":{"name":"Zihin.ai"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/zihin-ai/zihin-mcp.git"},"dependencies":{"@modelcontextprotocol/client":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_id":"@zihin/mcp-server@2.2.1","gitHead":"d61d0d22b6626e221e3fc78ed6aee45432a8230f","bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"homepage":"https://github.com/zihin-ai/zihin-mcp#readme","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-lgJcSD+zqkyvK2XyfsxvDcOyg2xRAKY97HGi8zJggNVIi7aWOkVdmIlEAEzzBzVwvL3RcWzpQy7hlpLX/kHeYA==","shasum":"dec8254567f38975606596785c0b83b1847c7aeb","tarball":"https://registry.npmjs.org/@zihin/mcp-server/-/mcp-server-2.2.1.tgz","fileCount":14,"unpackedSize":79850,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCID0qC0cfV93B+WwjoK8nwl3yxJzhBQg+V5g8PcBnCT4YAiEAs/ftCic7c0Fy2R97pe3cGEMYlpuIDi1Rd++aaitIryQ="}]},"_npmUser":{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"},"directories":{},"maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_2.2.1_1788309471854_0.6212819175662534"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T02:44:29.699Z","modified":"2026-09-02T00:37:52.205Z","1.0.0":"2026-03-10T02:44:29.976Z","1.1.0":"2026-03-13T16:41:05.653Z","1.2.0":"2026-03-21T16:33:35.912Z","1.3.0":"2026-03-28T21:39:56.484Z","1.4.0":"2026-07-02T00:15:46.226Z","2.0.0":"2026-08-02T13:26:39.124Z","2.0.1":"2026-08-02T13:46:10.326Z","2.1.0":"2026-08-02T14:26:28.833Z","2.2.0":"2026-09-01T00:08:21.230Z","2.2.1":"2026-09-02T00:37:52.016Z"},"bugs":{"url":"https://github.com/zihin-ai/zihin-mcp/issues"},"author":{"name":"Zihin.ai"},"license":"MIT","homepage":"https://github.com/zihin-ai/zihin-mcp#readme","keywords":["mcp","zihin","ai","agents","claude","cursor","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/zihin-ai/zihin-mcp.git"},"description":"Zihin MCP Server — stdio-to-HTTP proxy para Claude Desktop, Cursor, Claude Code e outros clientes MCP","maintainers":[{"name":"oliveiraronan","email":"ronan.oliveira@aionz.com.br"}],"readme":"# @zihin/mcp-server\n\nProxy MCP stdio-to-HTTP para a plataforma [Zihin.ai](https://zihin.ai). Conecta clientes MCP ao Zihin MCP Server via HTTP.\n\n```\nCliente MCP <-stdio-> [@zihin/mcp-server] <-HTTP-> https://llm.zihin.ai/mcp\n```\n\n## Inicio rapido\n\nmacOS / Linux:\n\n```bash\nZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server\n```\n\nWindows (PowerShell):\n\n```powershell\n$env:ZIHIN_API_KEY=\"zhn_live_xxx\"; npx @zihin/mcp-server\n```\n\n> Na pratica, a maioria dos clientes MCP (Claude Desktop, Cursor, etc.) define a variavel automaticamente via bloco `\"env\"` na configuracao — nao e necessario definir manualmente no shell.\n\n## Configuracao\n\n### Claude Desktop\n\nAdicione ao `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zihin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zihin/mcp-server\"],\n      \"env\": {\n        \"ZIHIN_API_KEY\": \"zhn_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdicione ao `.mcp.json` do projeto:\n\n```json\n{\n  \"mcpServers\": {\n    \"zihin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zihin/mcp-server\"],\n      \"env\": {\n        \"ZIHIN_API_KEY\": \"zhn_live_xxx\"\n      }\n    }\n  }\n}\n```\n\nOu via CLI (a variavel `ZIHIN_API_KEY` deve estar definida no shell):\n\n```bash\nclaude mcp add zihin -e ZIHIN_API_KEY=zhn_live_xxx -- npx -y @zihin/mcp-server\n```\n\n### Cursor\n\nAdicione ao `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zihin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zihin/mcp-server\"],\n      \"env\": {\n        \"ZIHIN_API_KEY\": \"zhn_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdicione ao `~/.windsurf/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zihin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zihin/mcp-server\"],\n      \"env\": {\n        \"ZIHIN_API_KEY\": \"zhn_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### Codex (OpenAI)\n\nAdicione ao `~/.codex/config.toml` (ou `.codex/config.toml` no projeto):\n\n```toml\n[mcp_servers.zihin]\ncommand = \"npx\"\nargs = [\"-y\", \"@zihin/mcp-server\"]\nenv_vars = [\"ZIHIN_API_KEY\"]\n```\n\nA variavel `ZIHIN_API_KEY` deve estar definida no seu shell. Alternativamente, para definir inline:\n\n```toml\n[mcp_servers.zihin]\ncommand = \"npx\"\nargs = [\"-y\", \"@zihin/mcp-server\"]\n\n[mcp_servers.zihin.env]\nZIHIN_API_KEY = \"zhn_live_xxx\"\n```\n\n### Outros clientes MCP\n\nQualquer cliente que suporte o protocolo MCP via stdio pode usar este pacote. O padrao de configuracao e o mesmo: executar `npx -y @zihin/mcp-server` com a variavel `ZIHIN_API_KEY` definida.\n\n## Variaveis de ambiente\n\n| Variavel | Obrigatoria | Descricao |\n|----------|-------------|-----------|\n| `ZIHIN_API_KEY` | Sim | API Key do tenant (formato `zhn_live_*`, `zhn_test_*` ou `zhn_dev_*`) |\n| `ZIHIN_MCP_URL` | Nao | URL do MCP Server (default: `https://llm.zihin.ai/mcp`) |\n| `ZIHIN_MCP_CALL_TIMEOUT_MS` | Nao | Teto de tempo de um `tools/call`, em milissegundos (default: `300000`, 5 min; faixa aceita: `1000`–`1800000`). O server tem deadline proprio por canal (chat 150s, builder 180s, async 240s) — o default deixa o server responder o erro diagnosticavel antes de o proxy cortar. Acima de ~300s o `fetch` do Node (undici) pode cortar antes, com timeout proprio de headers/body. |\n\n## Como funciona\n\nO pacote atua como um **proxy transparente** entre o cliente MCP local (via stdio) e o Zihin MCP Server (via HTTP):\n\n- Todas as tools, resources e prompts sao descobertos automaticamente do server\n- Auth, RBAC e tenant isolation sao enforced server-side via API Key\n- O role (admin/editor/member) e determinado pela API Key\n\n## Skills — deixe seu IDE especialista no Zihin\n\nO servidor expoe 6 skills (playbooks procedurais: criar agente, tools, triggers, diagnostico, governanca) como resources `zihin://skills/*` — todo client MCP ja as recebe automaticamente, sem instalar nada.\n\nPara instalar tambem no formato NATIVO do seu client (ativacao automatica por contexto):\n\n```bash\n# Claude Code (Agent Skills em .claude/skills/)\nZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client claude\n\n# Cursor (.cursor/rules/*.mdc) | Windsurf (.windsurf/rules/) | Codex (AGENTS.md + .zihin/skills/)\nZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client cursor\nZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server install-skills --client all\n\n# Offline (usa as skills empacotadas no npm)\nnpx @zihin/mcp-server install-skills --client claude --bundled\n```\n\nOpcoes: `--client claude|cursor|windsurf|codex|all` · `--dir <raiz-do-projeto>` · `--global` (so claude, instala em `~/.claude/skills`) · `--bundled` (offline).\n\nAs skills sao buscadas do server vivo (sempre atualizadas). No Codex, um bloco gerenciado e inserido no `AGENTS.md` (entre `<!-- zihin-skills:start/end -->`, idempotente) com o indice das skills em `.zihin/skills/`.\n\n### Plugin Claude Code (MCP + skills em um comando)\n\n```bash\nclaude plugin marketplace add zihin-ai/zihin-mcp\nclaude plugin install zihin@zihin\n```\n\nO plugin instala o MCP server (via este pacote) + as 6 skills. Requer `ZIHIN_API_KEY` exportada no ambiente.\n\n## Capabilities\n\nAs capabilities disponiveis dependem do role da API Key, controlado server-side:\n\n| Role | Tools | Resources | Prompts |\n|------|-------|-----------|---------|\n| `admin` | Todas (96) | 20 | 3 |\n| `editor` | Leitura (52 — writes nao sao listadas) | 20 | 3 |\n| `member` | Subset consumer (5) | - | - |\n\nContagens verificadas contra producao em 31/08/2026 (96 tools / 20 resources — 3 catalogos + 11 schemas + 6 skills / 3 prompts). O numero exato pode variar conforme o server evolui.\n\n### Resources disponiveis\n\n| URI | Descricao |\n|-----|-----------|\n| `zihin://agents` | Lista de agentes do tenant |\n| `zihin://models` | Catalogo de modelos LLM disponiveis |\n| `zihin://schema-templates` | Templates de schema para configuracao |\n| `zihin://schemas/{tipo}` | Contrato formal (JSON Schema) de cada payload — o mesmo que o server valida (11 tipos) |\n| `zihin://skills/{slug}` | Playbooks procedurais (6 skills — ver secao Skills acima) |\n\n### Prompts disponiveis\n\n| Nome | Descricao |\n|------|-----------|\n| `setup-agent` | Cria um agente completo (agente + persona + tools + publicacao) |\n| `add-tool` | Adiciona uma tool a um agente existente |\n| `configure-webhook` | Configura trigger webhook para um agente |\n\n## Testes\n\n62 testes: unitarios offline (classificacao de erros, teto de timeout, install-skills) + integracao real contra o server de producao. Sem `ZIHIN_API_KEY`, so os offline rodam; com a key, a suite completa:\n\n```bash\nZIHIN_API_KEY=zhn_live_xxx npm test\n```\n\nCobertura: validacao de API Key, tools (incluindo `chat_with_agent` com session tracking, continuidade e o contrato de saida — `execution_id`, `cancelled`, `tools_used`/`tool_calls`), resources, prompts, protocolo MCP (identidade espelhada + instructions), classificacao de erros (formas SDK v1 e v2) e o teto de `tools/call` conferido contra o deadline do server.\n\n> A suite de integracao executa um turno REAL de agente (custo de LLM no tenant). No CI ela roda apenas no gate de publish.\n\n## Troubleshooting\n\n### \"ERRO: ZIHIN_API_KEY nao definida\"\n\nDefina a variavel de ambiente antes de rodar:\n\n```bash\n# macOS / Linux\nZIHIN_API_KEY=zhn_live_xxx npx @zihin/mcp-server\n\n# Windows (PowerShell)\n$env:ZIHIN_API_KEY=\"zhn_live_xxx\"; npx @zihin/mcp-server\n```\n\n### \"Falha ao conectar ao server\"\n\n- Verifique sua conexao com a internet\n- Verifique se a API Key e valida e esta ativa\n- Se usar URL customizada, verifique `ZIHIN_MCP_URL`\n\n### \"ERRO FATAL: API Key invalida ou revogada\"\n\nA API Key foi revogada ou desativada no painel Zihin. Gere uma nova key e atualize a configuracao do cliente MCP. Reinicie o processo apos a troca.\n\n### \"A tool X passou do teto de 300s do proxy e foi abortada\"\n\nO proxy espera ate 5 minutos por um `tools/call`. Quando essa mensagem aparece, o limite atingido foi o **do proxy**, nao o do server — o trabalho foi cancelado no servidor (no dialeto 2026-07-28 o abort do request e o sinal de cancelamento), entao nao ha execucao orfa queimando token.\n\n- Turno de agente legitimamente longo: suba o teto com `ZIHIN_MCP_CALL_TIMEOUT_MS` (em milissegundos, faixa `1000`–`1800000`). Acima de ~300s o proprio `fetch` do Node pode cortar antes.\n- Quem estourou primeiro foi o **server** (deadline por canal: chat 150s, builder 180s, async 240s): a mensagem que chega e outra, um erro `TURN_TIMEOUT` com `execution_id` e `session_id` — leve esses dois identificadores para o suporte, sao a correlacao com a execucao no servidor.\n- Cliente MCP tem timeout proprio, independente deste: se o host desistir antes, ele mostra o erro dele.\n\n### Tools nao aparecem no cliente\n\n- Reinicie o cliente MCP apos alterar a configuracao\n- Claude Desktop: verifique logs em `~/Library/Logs/Claude/mcp*.log` (macOS) ou `%APPDATA%\\Claude\\logs\\mcp*.log` (Windows)\n\n## Limitacoes\n\n- **Turno longo tem teto**: `tools/call` espera no maximo 5 min no proxy (configuravel — ver `ZIHIN_MCP_CALL_TIMEOUT_MS`), e o server tem deadline proprio por canal (chat 150s, builder 180s, async 240s). Turno que passa disso e cancelado, nao enfileirado.\n- **Streaming**: A tool `chat_with_agent` retorna a resposta completa de uma vez (sincrono). O protocolo MCP define que tools retornam um `CallToolResult` completo — nao ha suporte a streaming progressivo. Para feedback em tempo real durante execucao do agente, use o endpoint REST SSE (`POST /api/v2/agents/:agent_id/stream`).\n\n## Requisitos\n\n- Node.js >= 20\n- Compativel com macOS, Linux e Windows\n\n## Licenca\n\nMIT\n","readmeFilename":"README.md"}