Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

claude-skills-mcp

> 编程语言
Open source

MCP server for searching and retrieving Scientific Agent Skills using vector search

395 stars0 likes2 views
WebsiteGitHub

About

MCP server for searching and retrieving Scientific Agent Skills using vector search

Claude Skills MCP Server

This MCP server is no longer hosted or maintained. Agent Skills have been natively adopted by all major AI platforms — Cursor, Windsurf, Claude Code, Copilot, and others now support skills out of the box. There is no longer a need for an MCP bridge to deliver skills to your coding assistant. The final release (v1.1.0) remains installable from PyPI. Thank you to everyone who used and contributed to this project!


Use Claude's powerful Skills system with ANY AI model or coding assistant - including Cursor, Codex, GPT-5, Gemini, and more. This MCP server brings Anthropic's Agent Skills framework to the entire AI ecosystem through the Model Context Protocol.

A Model Context Protocol (MCP) server that provides intelligent search capabilities for discovering relevant Claude Agent Skills using vector embeddings and semantic similarity. This server implements the same progressive disclosure architecture that Anthropic describes in their Agent Skills engineering blog, making specialized skills available to any MCP-compatible AI application.

An open-source project by K-Dense - creators of autonomous AI scientists for scientific research.

This MCP server enables any MCP-compatible AI assistant to intelligently search and retrieve skills from our curated Scientific Agent Skills repository and other skill sources like the Official Claude Skills.

Demo

Semantic search and progressive loading of Claude Agent Skills in Cursor

Highlights

  • Two-Package Architecture: Lightweight frontend (~15 MB) starts instantly; backend (~250 MB) downloads in background
  • No Cursor Timeout: Frontend responds in config.json

2. Edit config.json to your needs

3. Run with your custom configuration

uvx claude-skills-mcp --config config.json


## Documentation

- **[Getting Started](docs/getting-started.md)** - Installation, Cursor setup, CLI usage, and troubleshooting
- **[Architecture Guide](docs/architecture.md)** - Two-package design, data flow, and components
- **[API Documentation](docs/api.md)** - Tool parameters, examples, and best practices
- **[Usage Examples](docs/usage.md)** - Advanced configuration, real-world use cases, and custom skill creation
- **[Auto-Update Feature](docs/auto-update.md)** - Automatic hourly skill source refresh and change detection
- **[Testing Guide](docs/testing.md)** - Complete testing instructions, CI/CD, and coverage analysis

## MCP Tools

The server provides three tools for working with Claude Agent Skills:

1. **`find_helpful_skills`** - Semantic search for relevant skills based on task description
2. **`read_skill_document`** - Retrieve specific files (scripts, data, references) from skills  
3. **`list_skills`** - View complete inventory of all loaded skills (for exploration/debugging)

See [API Documentation](docs/api.md) for detailed parameters, examples, and best practices.

## Architecture

The system uses a **two-package architecture** for optimal performance:

- **Frontend** ([`claude-skills-mcp`](https://pypi.org/project/claude-skills-mcp/)): Lightweight proxy (~15 MB)
  - Starts instantly (<5 seconds) ✅ **No Cursor timeout!**
  - Auto-downloads backend on first use
  - MCP server (stdio) for Cursor
  
- **Backend** ([`claude-skills-mcp-backend`](https://pypi.org/project/claude-skills-mcp-backend/)): Heavy server (~250 MB)
  - Vector search with PyTorch & sentence-transformers
  - MCP server (streamable HTTP)
  - Auto-installed by frontend OR deployable standalone

**Benefits:**
- ✅ Solves Cursor timeout issue (frontend starts instantly)
- ✅ Same simple user experience (`uvx claude-skills-mcp`)
- ✅ Backend downloads in background (doesn't block Cursor)
- ✅ Can connect to remote hosted backend (no local install needed)

See [Architecture Guide](docs/architecture.md) for detailed design and data flow.

## Skill Sources

Load skills from **GitHub repositories** (direct skills or Claude Code plugins) or **local directories**. 

By default, loads from:
- [Official Anthropic Skills](https://github.com/anthropics/skills) - diverse skills for documents, presentations, web artifacts, and more
- [K-Dense Scientific Agent Skills](https://github.com/K-Dense-AI/claude-scientific-skills) - 148+ specialized skills for bioinformatics, cheminformatics, and scientific analysis
- Local directory `~/.claude/skills` (if it exists)

## Contributing

As this project is no longer maintained, new issues and pull requests may not be reviewed. If you'd like to build on it, please fork the repository. For reference, the original workflow was:

1. **Report issues**: [Open an issue](https://github.com/K-Dense-AI/claude-skills-mcp/issues) for bugs or feature requests
2. **Submit PRs**: Fork, create a feature branch, ensure tests pass (`uv run pytest tests/`), then submit
3. **Code style**: Run `uvx ruff check src/` before committing
4. **Add tests**: New features should include tests

### Development

**Version Management**: This monorepo uses a centralized version system:
- Edit the `VERSION` file at the repo root to bump the version
- Run `python3 scripts/sync-version.py` to sync all references (or use `--check` to verify)
- The `scripts/build-all.sh` script automatically syncs versions before building

For questions, email [[email protected]](mailto:[email protected])

## Learn More

- [Agent Skills Documentation](https://docs.claude.com/en/docs/claude-code/skills) - Official Anthropic documentation on the Skills format
- [Agent Skills Blog Post](https://www.anthropic.com/news/skills) - Announcement and overview
- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol that makes cross-platform Skills possible
- [Engineering Blog: Equipping Agents for the Real World](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - Technical deep-dive on the Skills architecture

## License

This project is licensed under the [Apache License 2.0](LICENSE).

Copyright 2025-2026 K-Dense (https://www.k-dense.ai)

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Python

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言