{"id":30127633,"url":"https://github.com/moeki0/mcp-testing-library","last_synced_at":"2025-08-10T17:08:50.455Z","repository":{"id":286238487,"uuid":"960816139","full_name":"moeki0/mcp-testing-library","owner":"moeki0","description":"Test environment for MCP servers","archived":false,"fork":false,"pushed_at":"2025-04-10T05:35:26.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-31T13:37:10.878Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moeki0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-05T05:59:48.000Z","updated_at":"2025-04-10T05:35:29.000Z","dependencies_parsed_at":"2025-04-05T07:18:49.503Z","dependency_job_id":"65022e52-e130-484b-9f0d-306cfc00f0d5","html_url":"https://github.com/moeki0/mcp-testing-library","commit_stats":null,"previous_names":["moekiorg/mcp-testing-library","kawakamidev/mcp-testing-library"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/moeki0/mcp-testing-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeki0%2Fmcp-testing-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeki0%2Fmcp-testing-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeki0%2Fmcp-testing-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeki0%2Fmcp-testing-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moeki0","download_url":"https://codeload.github.com/moeki0/mcp-testing-library/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moeki0%2Fmcp-testing-library/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269756394,"owners_count":24470566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-10T17:08:44.904Z","updated_at":"2025-08-10T17:08:50.440Z","avatar_url":"https://github.com/moeki0.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Testing Library\n\nA CLI tool for running Model Context Protocol (MCP) tests.\n\n## Features\n\n- CLI tool for running MCP tests\n- Supports running individual test files or test patterns\n- Configurable test timeout and exclusion patterns\n- Verbose mode for detailed output\n- Written in TypeScript with full type support\n- Compatible with the Model Context Protocol SDK\n- Colorful test output for better readability\n- Comprehensive test coverage\n\n## Installation\n\nTo install as a development dependency in your project:\n\n```bash\nnpm install --save-dev mcp-testing-library\n```\n\n## Usage\n\n### Command Line Options\n\n```\nUsage: mcpt [options] [test-files...]\n\nOptions:\n  -v, --version             output version number\n  -e, --exclude \u003cpatterns\u003e  Exclude files matching the pattern (comma-separated)\n                           (default: \"**/node_modules/**,**/dist/**\")\n  -t, --timeout \u003cms\u003e        Set test timeout in milliseconds (default: \"30000\")\n  --pattern \u003cglob\u003e          Test file pattern to match (default: \"**/*.test.{js,ts}\")\n  --no-color                Disable colored output\n  -h, --help                display help for command\n```\n\n### Examples\n\nRun all tests in the project:\n\n```bash\nmcpt\n```\n\nRun a specific test file:\n\n```bash\nmcpt sample/index.test.ts\n```\n\nRun tests with a longer timeout:\n\n```bash\nmcpt --timeout 10000\n```\n\nRun tests without color output:\n\n```bash\nmcpt --no-color\n```\n\nExclude specific directories:\n\n```bash\nmcpt --exclude \"**/node_modules/**,**/dist/**,**/build/**\"\n```\n\n## Using in Code\n\nYou can also use the MCP test utilities directly in your code:\n\n```typescript\nimport { mcpt, expect } from 'mcp-testing-library';\n\n// Test a filesystem MCP server\nmcpt(\n  {\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/directory'],\n  },\n  async ({ tools, prompts, resources, isMethodExist }) =\u003e {\n    expect(tools.length).to.be.greaterThan(0);\n    expect(await isMethodExist('list-tools')).to.eq(true);\n\n    // More assertions...\n  }\n);\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoeki0%2Fmcp-testing-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoeki0%2Fmcp-testing-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoeki0%2Fmcp-testing-library/lists"}