Typescript MCP Server with Obsidian Integration
About
# Typescript MCP Server with Obsidian Integration A command-line interface for interacting with your Obsidian vault. ## Prerequisites - Node.js 14.x or later - npm or yarn - An Obsidian vault ## Setup 1. Clone the repository 2. Install dependencies: ``` npm install ``` 3. Create a `.env` file in the project root with…
Explore
- Search notes by text content with configurable result limits
- List notes in any vault directory (default 10 results)
- Read full content of a specific note file
- HTTP API endpoints for search, list, and read operations
- React frontend available at http://localhost:5173
- Global CLI installation for system-wide use
- Development mode with auto-reload via nodemon
- Node.js 14.x or later
- npm or yarn
- An Obsidian vault
The application uses the following environment variables:
- OBSIDIAN_VAULT_PATH: Path to your Obsidian vault (required)
- PORT: Port number for the server (default: 3000)
Create a .env file in the project root to set these variables:
OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault
PORT=3000
For easier access, you can install the CLI globally:
```bash
A command-line interface for interacting with your Obsidian vault.
Prerequisites
- Node.js 14.x or later
- npm or yarn
- An Obsidian vault
Setup
1. Clone the repository
2. Install dependencies:
npm install
3. Create a
.env file in the project root with your Obsidian vault path: OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault
Development
Client Application
To start the backend:
npm run dev
To start the React frontend:
1. Navigate to the client directory:
cd client
2. Install dependencies (if not already installed):
npm install
3. Start the development server:
npm run dev
The application will be available at http://localhost:5173 by default.
Available Scripts
This project includes several npm scripts to help with development and testing:
Start the Server Application
npm start
Starts the application using ts-node. The server will be available at http://localhost:3000 by default (or the port specified in your environment variables).
Development Mode with Auto-Reload
npm run dev
Starts the application in development mode using nodemon, which automatically restarts the server when you make changes to any TypeScript file in the src directory.
Build the Project
npm run build
Compiles TypeScript files to JavaScript in the dist directory.
Run Tests
npm test
Runs the test suite (currently no tests are configured).
Run CLI Tool
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



