docs: add contributing guide and update readme

CHANGES
- Add comprehensive CONTRIBUTING.md with development setup instructions
- Update README.md with demo link and enhanced project description
- Reorganize content by moving development details to contributing guide
- Update project date and improve section organization

IMPACT
- Contributors have clear setup and development guidelines
- README is more focused on user getting-started experience
- Better project organization with separated concerns

Author: KemingHe

CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# Contributing to Python Dependency Manager MCP Server
+
+> Updated on 2025-07-21 by @KemingHe
+
+Thank you for your interest in contributing! This document provides development setup instructions and guidelines.
+
+## 🛠️ Development Setup
+
+**Transport**: Stdio only (MCP standard for local tools).
+
+### Local Development
+
+```shell
+# Clone and setup
+git clone <repo-url>
+cd python-dep-manager-companion-mcp-server
+uv sync
+
+# Run server locally
+uv run --with fastmcp --with tantivy fastmcp run src/mcp_server.py
+
+# Build Docker image
+docker build -t py-dep-man-companion .
+```
+
+### Local Testing with MCP Client
+
+For testing the server locally during development, add this configuration to your VSCode/Cursor `mcp.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "py-dep-man-companion-native": {
+        "command": "uv",
+        "args": [
+          "run",
+          "--directory",
+          "/path/to/your/python-dependency-manager-companion-mcp-server",
+          "--with",
+          "fastmcp>=2.10.5",
+          "--with",
+          "tantivy>=0.24.0",
+          "fastmcp",
+          "run",
+          "src/mcp_server.py"
+        ]
+      }
+    }
+  }
+}
+```
+
+>[!IMPORTANT]
+> Replace `/path/to/your/python-dependency-manager-companion-mcp-server` with the absolute path to your local repository.
+
+## 🗺️ Roadmap
+
+Adding support for pipenv, pdm, pixi, and additional Python package managers.
+
+## 📝 Development Guidelines
+
+- Follow existing code style and structure
+- Test your changes locally using the native configuration above
+- Update documentation when adding new features
+- Submit pull requests with clear descriptions of changes
+
+## 🔄 Automated Updates
+
+This repository includes automated workflows that:
+
+- Update documentation weekly from official sources
+- Rebuild search indexes automatically
+- Publish multi-architecture Docker images
+
+See [.github/workflows/README.md](.github/workflows/README.md) for workflow details.

README.md

@@ -1,12 +1,18 @@
 # Python Dependency Manager MCP Server
 
-> Updated on 2025-07-15 by @KemingHe
+> Updated on 2025-07-21 by @KemingHe
 
-Local stdio MCP server providing unified search across Python dependency managers' latest and official documentation.
+Local stdio MCP server providing unified search across Python dependency managers' latest and official documentation. [[Demo]](https://www.loom.com/share/a80f6041dc374c07b95b2397ee4e8ca1?sid=1209cdce-7239-447e-8b20-49eae454cc9a)
 
 ## 📋 Overview
 
-Unified search for pip, poetry, uv, and conda docs via Docker with automated weekly updates. Built with FastMCP and Tantivy for simple, AI-less full-text search.
+Unified search for pip, poetry, uv, and conda docs via Docker with automated weekly updates. Built with FastMCP and Tantivy for simple, accurate, embedding-free, full-text search.
+
+## 🎯 Use as Template
+
+**General use**: [[Use this repository as a template]](https://github.com/new?template_name=python-dependency-manager-companion-mcp-server&template_owner=KemingHe) for your own MCP server projects.
+
+**Contributing**: _Fork only to contribute back._ See [./CONTRIBUTING.md](./CONTRIBUTING.md) for development setup.
 
 ## 🚀 Getting Started
 
@@ -61,31 +67,10 @@ python-dep-manager-companion-mcp-server/
 └── uv.lock                   # Locked dependencies
 ```
 
-## 🛠️ Development
-
-**Transport**: Stdio only (MCP standard for local tools).
-
-**Local Development**:
-
-```shell
-# Clone and setup
-git clone <repo-url>
-cd python-dep-manager-companion-mcp-server
-uv sync
-
-# Run server locally
-uv run --with fastmcp --with tantivy fastmcp run src/mcp_server.py
-
-# Build Docker image
-docker build -t py-dep-man-companion .
-```
-
-**Roadmap**: Adding support for pipenv, pdm, pixi, and additional Python package managers.
-
 ## 📄 License
 
 This project is licensed under the [MIT License](./LICENSE) - a permissive license that allows free use, modification, and distribution with attribution.
 
 ## 📞 Support
 
-Open GitHub issues for bug reports and feature requests. Documentation is automatically updated weekly via workflows (see [.github/workflows/README.md](.github/workflows/README.md)).
+Open GitHub issues for bug reports and feature requests. Documentation is automatically updated weekly via workflows (see [./.github/workflows/README.md](./.github/workflows/README.md)).